Category Feature element trees, Object ProElement

Function ProElementCollectionProcess


Description
Processes the collection contained in a given element according to the rules of the feature it belongs to. Unlike ProSrfcollectionRegenerate() and ProCrvcollectionRegenerate(), the results of this function are a true picture of which items are referenced by the collection stored in the feature.

Note: This function will not be able to extract geometry, if some or all of the resulting geometry is inactive due to material removal features occuring in the model. In order to extract the reference geometry for such a collection,use ProFeatureInsertModeActivate() to roll back the model before the material removal feature.

Synopsis
#include <ProElement.h>
ProErrorProElementCollectionProcess(
ProElement element
/* (In)
The PRO_E_STD_CURVE_COLLECTION_APPL or PRO_E_STD_SURFACE_COLLECTION_APPL element. If this element was extracted from an existing feature tree using ProFeatureElemtreeCreate(), the results will use the feature rules to determine the collected references. If this element is newly created and not yet assigned to a feature, the default rules are used like ProCrvcollectionRegenerate() and ProSrfcollectionRegenerate().
*/
ProReference** reference_array
/* (Out)
ProArray of references collected by the collection in the element. Free this array using ProReferencearrayFree() when finished with it.
*/
)
Returns
PRO_TK_NO_ERRORThe function succeeded.
PRO_TK_EMPTYIf the collection in element is empty.
PRO_TK_BAD_INPUTSOne or more inputs was invalid.
PRO_TK_GENERAL_ERRORError evaluating the collected references.

Manual References:

  1. User Interface: Curve and Surface Collection: Access of Collection Object from Feature Element Trees