All Frameworks Class Hierarchy This Framework Previous Next Indexes
System.IUnknown | +---System.IDispatch | +---System.CATBaseUnknown | +---CATIBodyRequest
Usage: an implementation of this interface is supplied and you must use it as is. You should not reimplement it.
interface CATIBodyRequest
Interface to retrieve the result of a geometrical feature set.
Role:This interface enables you to retrieve the result of a geometrical set.
This interface is available for all kind of geometrical features sets.
The unique method, GetResults , enables you to retrieve the result of a geometrical feature set.
The result of a geometrical feature set is made from all the geometrical features that are aggregated in
this geometrical set and that are not absorbed.
It can be directly aggregated (a Point under the the geometrical feature set),
or indirectly (a Point under a Line that is under the geometrical feature set).
This method works for nearly any kind of geometrical features sets.
In particular, this method works for a Body operated by a boolean operation.
This method does not work for sub-Body and sub-OGS (Body or OGS aggregated directly in an OGS or in a Body).
The method of this interface needs a context (It is a difference between
the
CATIDescendants interface). The context is the means to have for the same design several representations. There is a default context represented by
the MfDefault3DView string value.
In all cases, the result list contains features implementing the
CATI3DGeometricalElement interface. Once you have the resulting feature(s), use the
CATIGeometricalElement.GetBodyResult method to retrieve the associated CATBody.
Be aware that you can retrieve deactivated features in the list (see the
CATIMechanicalProperties interface). In that case, it can happen that the associated CATBody does not exist.
public virtual HRESULT GetResults( | const CATUnicodeString& | iViewContext, |
CATListValCATBaseUnknown_var& | oResults)=0 |
Retrieves the list of geometrical features directly aggregated by the geometrical feature set.
For instance, Geometric elements that are in a GS (GS2) under GS1 are not retrieved.
To retrieve them, you have to call
CATIBodyRequest on GS2.
For a Solid feature set, GetResults also takes into consideration the sketches located inside the
possible operated Solid feature sets.
Retrieves the list of geometrical features aggregated by the OGS (OGS1) and sub-geometrical feature set. Contrary to Geometrical Set, Geometric elements that are in a OGS (OGS2) under OGS1 are also retrieved. On this example, CATIBodyRequest on OGS2 doesn't work. If the geometrical feature set contains Solid feature, the resulting Solid feature is the first element of the list. Next features in the list are Surfacic features. Note that the resulting Solid feature can be a feature not displayed to the user (internal feature).
Copyright © 2003, Dassault Systèmes. All rights reserved.