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>
ProElementCollectionProcess | |
( 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
The function succeeded. | |
If the collection in element is empty. | |
One or more inputs was invalid. | |
Error evaluating the collected references. |
User Guide References