CATMecModLiveUseItf Interface 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.

• Surfacic features sets:
  
  
  • Geometrical Set (or GS) (startup: GSMTool)
  
  
  • Ordered Geometrical Set (or OGS) (startup: GSMTool)
  
  
• Bodies:
  
  
  • Solid features set (user name: Body) (startup: MechanicalTool)
  
  
  • Solid and Surfacic features set (user name: Body) (startup: HybridBody)

The method, , 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 first method of this interface needs a context. 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 interface. Once you have the resulting feature(s), use the method to retrieve the associated CATBody. Be aware that you can retrieve deactivated features in the list (see the interface). In that case, it can happen that the associated CATBody does not exist.

See also:

Method Index

o GetDirectBodies(CATListValCATBaseUnknown_var&)

Retrieves geometrical feature sets (Bodies,OGS and GS) directly under this geometrical feature set.

o GetResults(CATUnicodeString&,CATListValCATBaseUnknown_var&)

Retrieves the result of a geometrical feature set.

Methods

Retrieves geometrical feature sets (Bodies,OGS and GS) directly under this geometrical feature set.

Parameters:

oBodies

A list containing the geometrical feature sets.

Retrieves the result of a geometrical feature set.

• For a Geometrical Set or a Solid features set

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 on GS2.
For a Solid feature set, GetResults also takes into consideration the sketches located inside the possible operated Solid feature sets.


• For a Ordered Geometrical Set or a Solid and Surfacic features set

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, 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).

Parameters:

iViewContext

The context of view:
Legal values:

• "MfUnfoldedView" or "Unfolded": for an unfolded view in Sheet Metal applications,
• "MfDefault3DView": for the default 3D view,
• otherwise: the default 3D view.

oResults

A list of geometrical features.

Copyright © 1999-2014, Dassault Systèmes. All rights reserved.