Feature References
Functions Introduced:
The function
ProFeatureReferenceEdit() replaces the old references of a feature with new references based on the bitmask specified for its input argument
flags. The bitmask must contain one or more regeneration control bit flags of the type
PRO_REGEN_* defined in
ProSolid.h. Refer to the
Regenerating a Solid topic in the
Core: Solids, Parts, and Materials section for more information on the bit flags.
The function
ProMdlFeatBackupOwnerNamesGet() returns the names of the models, along the model path, from the top model to the owner model for the specified feature. The input arguments are:
• model—Specifies the model, which contains the specified feature.
• feature—Specifies a feature whose references are to be retrieved.
The function
ProMdlFeatBackupRefMdlNamesGet() returns the names of the models, along the model path, from the top model to the external reference model for the specified feature. Feature references can be from a local or external model. The system creates a geometry backup of the local and external references, which is used for information and display purposes. This function retrieves the model names from the backup information. The input arguments are:
• model—Specifies the model, which contains the specified feature.
• feature—Specifies a feature whose references are to be retrieved.
• path—Specifies the path as a ProArray of IDs of a subassembly or component from the top model to the reference model. Specify NULL for local reference.
To give an example on how to specify the path, consider an assembly A, which has a component C1 with ID 9 and a subassembly S with ID 7. The subassembly S has a component C2 with ID 11. If a feature under C1 references an object in the model of C2, the reference ID path must contain two IDs 7 and 11.
• ref_id—Specifies the ID of the external reference, which is referenced in the specified feature.
Refer to the Creo Parametric Assembly Design online help for more information on references and backup data.
The function
ProFeatureReferenceEditRefsGet() returns an array of the original references of a feature that are used to perform the edit reference operation. The input arguments follow:
• solid—The part or assembly to which the features belong.
• p_feat_handle—The feature handle.
• flags—Indicates the type of references to collect. To collect all types of references, set the value to PRO_EDITREF_REF_TYPE_ALL.
The function returns the output argument r_orig_ref_arr as a ProArray of all the original references.
Use the function
ProReferencearrayFree() to free the memory.
Use the function
ProFeatureMdltreeDisplaynameGet() to retrieve the name of the node displayed in the model tree.