Modification of Annotation Elements
The functions described in this section allow you to modify the properties of an annotation element.
 The functions in this section are shortcuts to redefining the feature containing the annotation elements. Because of this, must regenerate the model after making the indicated changes to the annotation element. The functions include a flag to optionally allow the Fix Model User Interface to appear upon a regeneration failure. |
Functions Introduced:
The function ProAnnotationelemAnnotationSet() allows you to modify the annotation contained in an annotation element. Specify the value for the input argument annotation as NULL to modify the annotation element to be a non-graphical annotation.
|
The above function does not support Datum Target Annotation Elements (DTAEs). |
If you modify the annotation contained in the annotation element, the original annotation is automatically removed from the element and is owned by the model.
The function ProAnnotationelemCopySet() provides write access to the copy flag of the annotation element. This property is not supported for annotations in data sharing features.
The function ProAnnotationelemDependencySet() sets the value for the dependency flag. This property is supported only for annotations in data sharing features.
The function ProAnnotationelemReferenceAdd() adds a strong user-defined reference to the annotation element.
The function ProAnnotationelemReferenceRemove() removes the user defined reference from the annotation element.
The function ProAnnotationelemReferenceStrengthen() converts a weak reference to a strong reference.
The function ProAnnotationelemReferenceWeaken() converts a strong reference to a weak reference.
The function ProAnnotationelemReferenceDescriptionSet() sets the description property for a given annotation element reference.
The function ProAnnotationelemReferenceAutopropagateSet() sets the autopropagate flag of the specified annotation element reference.
The function ProAnnotationelemReferencesSet() replaces all the user-defined references in the annotation element with a ProArray of references specified as the input argument.
The function ProAnnotationelemArrayReferencesSet() replaces all the user-defined references for a ProArray of annotation elements with the ProArray of reference sets specified as the input argument.
|
All the annotation elements must belong to the same feature. The number of reference sets should match the number of annotation elements to be modified. |
The function ProAnnotationreferencesetAlloc() allocates a set of user-defined references to be assigned to an annotation element.
The function ProAnnotationreferencesetReferenceAdd() adds a new reference to an existing set of user-defined annotation references.
The function ProAnnotationelemReferencesInheritGet() checks if a child annotation element inherits references from its parent. The input argument elem specifies the annotation element using a ProAnnotationElem object. The output argument inherit returns PRO_B_TRUE if the element inherits references from the parent.
The function ProAnnotationelemReferencesInheritSet() sets the semantic inherit references flag in a child annotation element to inherit references from its parent. The input arguments are:
• elem—Specifies the annotation element using a ProAnnotationElem object.
• inherit—Specifies PRO_B_FALSE to disable inheritance of references from the parent if enabled and removes the parent-inherited references from the child annotation element.
The function ProAnnotationreferencesetFree() releases the set of user-defined references to be assigned to an annotation element.
The function ProAnnotationreferencesetProarrayFree() releases an array of reference sets to be assigned to an annotation element.
Example 1: Creating/ Adding Annotation Element Array Reference Set
The sample code in the file CreoTkAnnotationElemArrayReferencesSet.c located at <creo_toolkit_loadpoint>\protk_appls\pt_userguide\creotk_examples\creotk_annotations, shows how to add single or multiple references to an Annotation Element or Annotation Feature prior to single regeneration using ProAnnotationelemReferenceAdd().