Annotations: Annotation Features and Annotations
Overview of Annotation Features
An annotation feature is composed of one or more "annotation elements". Each annotation element is composed of references, parameters and annotations (notes, symbols, geometric tolerances, surface finishes, reference dimensions, driven dimensions, and manufacturing template annotations). The annotation feature allows annotation information to have the same benefits as geometry in Creo Parametric models, that is, parameters can be assigned to these annotation elements, and missing geometric references can cause features to fail in some situations.
Annotation elements may belong to annotation features, or may also be found in data-sharing features (features such as Copy Geometry, Publish Geometry, Merge, Cutout, and Shrinkwrap features).
Creo Object TOOLKIT Java does not expose the feature element tree for annotation features because some elements in the tree are used for non-standard purposes. Instead, Creo Object TOOLKIT Java provides specific methods for creating, redefining, and reading the properties of annotation features and annotation elements.
Creating Annotation Features
Methods Introduced:
  • wfcSelect.WSelection.CreateAnnotationFeature
    		•
    The method wfcSelect.WSelection.CreateAnnotationFeature creates a new annotation feature in the model as a wfcFeature.AnnotationFeature object. InvokeUI specifies a boolean flag that determines how the annotation features will be created. It can have the following values:
    •  FALSE—Indicates that the feature will be a new empty annotation feature with one general annotation element in it. Modify the new annotation element and add others using subsequent steps.
    •  TRUE—Indicates that Creo Parametricwill invoke the annotation feature creation user interface.
    Redefining Annotation Features
    Redefining an annotation feature involves creation of new annotation elements, deletion of elements that are not required and modification of the feature properties.
    Note
    The methods in this section are shortcuts to redefining the feature containing the annotation elements. Due to this, Creo Parametric must regenerate the model after making the required changes to the annotation element. The methods include a flag to optionally allow the Fix Model User Interface to appear upon a regeneration failure.
    Methods Introduced:
  • wfcSelect.WSelection.AddAnnotationElement
    		•
  • wfcSelect.WSelection.AddElementsInAnnotationFeature
    		•
  • wfcSelect.WSelection.CopyAnnotationElement
    		•
  • wfcSelect.WSelection.DeleteAnnotationElement
    		•
  • wfcSelect.WSelection.DeleteElementsInAnnotationFeature
    		•
    The method wfcSelect.WSelection.AddAnnotationElement adds a new non-graphical annotation element to the feature as a wfcAnnotation.AnnotationElement object.
    The method wfcSelect.WSelection.AddElementsInAnnotationFeature adds a series of new annotation elements to the annotation feature as a wfcAnnotation.AnnotationElements object. Each element may be created as non-graphical or may be assigned a pre-existing annotation.
    Note
    In case of Datum Target Annotation Features (DTAFs), you can add only one set datum tag annotation element using the method wfcSelect.WSelection.AddElementsInAnnotationFeature.
    The method wfcSelect.WSelection.CopyAnnotationElement copies and adds an existing annotation element to the specified annotation feature.
    The method wfcSelect.WSelection.DeleteAnnotationElement deletes an annotation element from the feature. The method deletes the annotation element, its annotations, parameters, references, and application data from the feature.
    Note
    In case of Datum Target Annotation Features (DTAFs), the method wfcSelect.WSelection.DeleteAnnotationElement allows you to delete only a Datum Target Annotation Element (DTAE) from a DTAF. This method does not allow deletion of a set datum tag annotation element from the DTAF.
    The method wfcSelect.WSelection.DeleteElementsInAnnotationFeature deletes a series of annotation elements from the feature. The method deletes the annotation element, its annotations, parameters, references, and application data from the feature.
    Note
    In case of Datum Target Annotation Features (DTAFs), the method wfcSelect.WSelection.DeleteElementsInAnnotationFeature allows you to delete only a Datum Target Annotation Element (DTAE) from a DTAF. This method does not allow deletion of a set datum tag annotation element from the DTAF.
    Accessing Annotations
    Methods Introduced:
  • wfcAnnotation.Annotation.ShowInDrawing
    		•
  • wfcAnnotation.Annotation.Display
    		•
  • wfcAnnotation.Annotation.DisplayInDrawing
    		•
  • wfcAnnotation.Annotation.Undisplay
    		•
  • wfcAnnotation.Annotation.UndisplayInDrawing
    		•
  • wfcAnnotation.Annotation.Update
    		•
  • wfcAnnotation.Annotation.IsInactive
    		•
  • wfcAnnotation.Annotation.IsUsingXSecReference
    		•
  • wfcWDrawing.WDrawing.EraseAnnotation
    		•
  • wfcSelect.WSelection.ShowAnnotations
    		•
  • wfcSelect.WSelection.ShowAxes
    		•
  • wfcSelect.WSelection.ShowDatumTargets
    		•
  • wfcView2D.WView2D.ShowAnnotations
    		•
  • wfcView2D.WView2D.ShowAxes
    		•
  • wfcView2D.WView2D.ShowDatumTargets
    		•
    The method wfcAnnotation.Annotation.ShowInDrawing shows the annotation in the current combined state. The annotation will be visible until it is explicitly erased from the combined state. The method also adds the specified annotation to the current combined state, if it has not been added. If the specified annotation has been erased, then the method changes the display status of the erased annotation and makes it visible in the combined state, that is, it unerases the annotation. This function is also capable of showing an annotation in a drawing view similar to the Creo Parametric command Show and Erase. The input arguments are:
    •  DrawingView—Specifies the drawing view.
    •  CompPath—Specifies the assembly component path.
    The methods wfcAnnotation.Annotation.Display and wfcAnnotation.Annotation.Undisplay temporarily display and remove an annotation from the display for the specified combined state .
    Similarly, the methods wfcAnnotation.Annotation.DisplayInDrawing and wfcAnnotation.Annotation.UndisplayInDrawing temporarily display and remove an annotation from the display for the specified drawing. Specify the drawing in the input argument DrawingModel The undisplay and display methods for combined state and drawing should be used together. To edit a shown annotation, it must be first removed temporarily from display by using the undisplay method, followed by editing the annotation. The annotation must be redisplayed using the display method, so that the updated annotation is visible to the user.
    The method wfcAnnotation.Annotation.Update updates the display of an annotation, but does not actually display it. If the annotation is not currently displayed because it is hidden by layer status or inactive geometry, the text extracted from the annotation may include callout symbols, instead of the text shown to the user. The method wfcAnnotation.Annotation.Update informs Creo Parametric to update the contents of the annotation in order to cross-reference these callout values. This method supports 3D model notes and detail notes.
    The method wfcAnnotation.Annotation.IsInactive indicates whether the annotation can be shown or not. An annotation becomes inactive if all the weak references it points to have been lost or consumed.
    The method wfcAnnotation.Annotation.IsUsingXSecReference identifies if the annotation is created on or attached to a cross-sectional edge.
    The method wfcWDrawing.WDrawing.EraseAnnotation removes an annotation from the display for the specified drawing. The annotation is not shown in the specified drawing.
    Note
    The annotation which was removed from the display using the method wfcWDrawing.WDrawing.EraseAnnotation will become visible again, only if the method wfcAnnotation.Annotation.ShowInDrawing is called to explicitly display the annotation.
    The method wfcSelect.WSelection.ShowAnnotations displays the annotation of the specified type for the selected feature or component.
    The method wfcSelect.WSelection.ShowAxes displays the axes for the selected feature and component.
    The method wfcSelect.WSelection.ShowDatumTargets displays the datum targets for the selected feature and component.
    Note
    In case of methods wfcSelect.WSelection.ShowAnnotations, wfcSelect.WSelection.ShowAxes, and wfcSelect.WSelection.ShowDatumTargets, for annotations created in drawing mode and owned by a solid, which can be displayed only in the context of that drawing, specify the name of the drawing in the input argument drawing. You can specify the view in which the annotations for the selected feature and component must be displayed. If you pass the input argument DrawingView as NULL, the annotations are displayed in all the views.
    The method wfcView2D.WView2D.ShowAnnotations displays the annotation of the specified type in the drawing view by using the enumerated data type wfcAnnotation.AnnotationType.
    The method wfcView2D.WView2D.ShowAxes displays the axes in the drawing view.
    The method wfcView2D.WView2D.ShowDatumTargets displays the datum targets in the drawing view.
    Accessing and Modifying Annotation Elements
    The following methods provide access and modify the properties of an annotation element.
    Note
    The methods in this section are shortcuts to redefining the feature containing the annotation elements. Because of this, Creo Parametric must regenerate the model after making the indicated changes to the annotation element. The methods include a flag to optionally allow the Fix Model User Interface to appear upon a regeneration failure.
    Methods Introduced:
  • wfcAnnotation.Annotation.GetAnnotationElement
    		•
  • wfcAnnotation.Annotation.GetAnnotationElementWithOption
    		•
  • wfcAnnotation.AnnotationElement.GetAnnotationType
    		•
  • wfcAnnotation.AnnotationElement.IsReadOnly
    		•
  • wfcAnnotation.AnnotationElement.HasMissingReferences
    		•
  • wfcAnnotation.AnnotationElement.IsIncomplete
    		•
  • wfcAnnotation.AnnotationElement.GetCopyFlag
    		•
  • wfcAnnotation.AnnotationElement.IsDependent
    		•
  • wfcAnnotation.AnnotationElement.GetAnnotation
    		•
  • wfcAnnotation.AnnotationElement.GetAnnotationFeature
    		•
  • wfcAnnotation.AnnotationElement.IsReferenceStrong
    		•
  • wfcAnnotation.AnnotationElement.CollectAnnotationReferences
    		•
  • wfcAnnotation.AnnotationElement.CollectQuiltReferenceSurfaces
    		•
  • wfcAnnotation.AnnotationElement.GetAnnotationReferenceDescription
    		•
  • wfcAnnotation.AnnotationElement.SetAnnotationReferenceDescription
    		•
  • wfcSelect.WSelection.SetAnnotationInAnnotationElement
    		•
  • wfcSelect.WSelection.SetCopyFlagInAnnotationElement
    		•
  • wfcSelect.WSelection.SetDependencyFlag
    		•
  • wfcSelect.WSelection.GetAutoPropagateFlagInAnnotationElement
    		•
  • wfcSelect.WSelection.SetAutoPropagateFlagInAnnotationElement
    		•
  • wfcSelect.WSelection.AddAnnotationReferenceInAnnotationElement
    		•
  • wfcSelect.WSelection.SetAnnotationReferencesInAnnotationElement
    		•
  • wfcSelect.WSelection.RemoveAnnotationReferenceInAnnotationElement
    		•
  • wfcSelect.WSelection.SetAnnotationElementReferences
    		•
  • wfcAnnotation.wfcAnnotation.AnnotationReferenceSet_Create
    		•
  • wfcAnnotation.AnnotationReferenceSet.GetReference
    		•
  • wfcAnnotation.AnnotationReferenceSet.SetReference
    		•
  • wfcAnnotation.AnnotationReferenceSet.GetStrong
    		•
  • wfcAnnotation.AnnotationReferenceSet.SetStrong
    		•
  • wfcAnnotation.AnnotationReferenceSet.GetDescription
    		•
  • wfcAnnotation.AnnotationReferenceSet.SetDescription
    		•
  • wfcAnnotation.AnnotationReferenceSet.GetAutoPropagate
    		•
  • wfcAnnotation.AnnotationReferenceSet.SetAutoPropagate
    		•
  • wfcSelect.WSelection.StrengthenAnnotationElementReference
    		•
  • wfcSelect.WSelection.WeakenAnnotationElementReference
    		•
  • wfcAnnotation.AnnotationReferenceCurveCollectionObject_Create
    		•
  • wfcAnnotation.AnnotationReferenceCurveCollectionObject.GetCurveCollection
    		•
  • wfcAnnotation.AnnotationReferenceCurveCollectionObject.SetCurveCollection
    		•
  • wfcAnnotation.AnnotationReferenceSelectionObject_Create
    		•
  • wfcAnnotation.AnnotationReferenceSelectionObject.GetReference
    		•
  • wfcAnnotation.AnnotationReferenceSelectionObject.SetReference
    		•
  • wfcAnnotation.AnnotationReferenceSurfaceCollectionObject_Create
    		•
  • wfcAnnotation.AnnotationReferenceSurfaceCollectionObject.GetSurfaceCollection
    		•
  • wfcAnnotation.AnnotationReferenceSurfaceCollectionObject.SetSurfaceCollection
    		•
    The method wfcAnnotation.Annotation.GetAnnotationElement retrieves the annotation element that contains the annotation as a wfcAnnotationElement object.
    The method wfcAnnotation.Annotation.GetAnnotationElementWithOption
    The method wfcAnnotation.AnnotationElement.GetAnnotationType returns the type of the annotation contained in the annotation element using the enumerated data type wfcAnnotation.AnnotationType. The valid values are:
    •  ANNOTATION_NOTE—Specifies a note.
    •  ANNOTATION_GTOL—Specifies a geometric tolerance.
    •  ANNOTATION_SURFACE_FINISH—Specifies a surface finish.
    •  ANNOTATION_SYMBOL_INSTANCE—Specifies a symbol.
    •  ANNOTATION_DIMENSION—Specifies a driven dimension.
    •  ANNOTATION_REF_DIMENSION—Specifies a reference dimension.
    •  ANNOTATION_SET_DATUM_TAG—Specifies a set datum tag.
    The method wfcAnnotation.AnnotationElement.IsReadOnly checks if the annotation element has read only or full access.
    The method wfcAnnotation.AnnotationElement.HasMissingReferences checks if an annotation element has missing references. Use the input parameters of this method to investigate specific types and sources of references, or to check all references simultaneously. The input arguments are:
    •  ReferenceType—Specifies the type of reference by using the enumerated data type wfcAnnotation.AnnotationRefFilter. The valid values are:
    ○  ANNOTATION_REF_ALL—Specifies all references.
    ○  ANNOTATION_REF_WEAK—Specifies weak references.
    ○  ANNOTATION_REF_STRONG—Specifies strong references.
    •  ReferenceSource—Specifies the source of the references by using the enumerated data type wfcAnnotation.AnnotationRefFromType. The valid values are:
    ○  ANNOT_REF_FROM_ALL—Specifies all references.
    ○  ANNOT_REF_FROM_ANNOTATION—Specifies references from annotations.
    ○  ANNOT_REF_FROM_USER—Specifies references from users.
    •  AtLeastOneMissingRef—Specifies if the annotation element has at least one missing reference of the specified type and source.
    Use the method wfcAnnotation.AnnotationElement.IsIncomplete returns a true value if the annotation element is incomplete because of missing strong references.
    The method wfcAnnotation.AnnotationElement.GetCopyFlag retrieves the copy flag of the annotation elements. This property is not supported for elements in data sharing features. It returns true if the annotation element contains copies of its references.
    The method wfcSelect.WSelection.SetCopyFlagInAnnotationElement sets the copy flag of the annotation element. Set the input argumentInvokeUI to true to allow theFix Model User Interface to appear upon a regeneration failure. This property is not supported for annotations in data sharing features.
    The method wfcAnnotation.AnnotationElement.IsDependent retrieves the value of the dependency flag for the annotation element. This property is supported only for the elements in data sharing features. It returns true if the annotation element is dependent on its parent.
    The method wfcSelect.WSelection.SetDependencyFlag sets the dependency flag of the annotation element. This property is supported only for annotations in data sharing features.
    The method wfcAnnotation.AnnotationElement.GetAnnotation returns the annotation contained in an annotation element.
    The method wfcAnnotation.AnnotationElement.GetAnnotationFeature returns the feature that owns the annotation element as a pfcFeature.Feature object.
    The method wfcAnnotation.AnnotationElement.IsReferenceStrong identifies if a reference is weak or strong in a given annotation element.
    The method wfcAnnotation.AnnotationElement.CollectAnnotationReferences retrieves an array of references contained in the specified annotation element as a wfcAnnotation.AnnotationReferences object. The input arguments are:
    •  RefStrength—Specifies the type of reference by using the enumerated data type wfcAnnotation.AnnotationRefFilter.
    •  RefSource—Specifies the source of the references by using the enumerated data type wfcAnnotation.AnnotationRefFromType.
    The method wfcAnnotation.AnnotationElement.CollectQuiltReferenceSurfaces returns the surfaces which make up a quilt surface collection reference for the annotation element as a wfcAnnotation.AnnotationReferences object.
    Note
    All the surfaces made inactive by features occurring after the annotation element in the model regeneration are also returned.
    The method wfcAnnotation.AnnotationElement.GetAnnotationReferenceDescription retrieves the description property for a given annotation element reference.
    Note
    The description string is the same as that of the tooltip text for the reference name in the Annotation Feature UI.
    The method wfcAnnotation.AnnotationReference.GetAnnotationReferenceType retrieves the type of the annotation reference by using the enumerated data type wfcAnnotation.AnnotationRefType. The valid values are:
    •  ANNOT_REF_SINGLE—Specifies a single reference.
    •  ANNOT_REF_CRV_COLLECTION—Specifies the collection of curves.
    •  ANNOT_REF_SRF_COLLECTION—Specifies the collection of surfaces.
    The method wfcAnnotation.AnnotationElement.SetAnnotationReferenceDescription sets the description property for a given annotation element reference. The input arguments are:
    •  Reference—Specifies the annotation reference as a wfcAnnotation.AnnotationReference object.
    •  Description—Specifies the description for the annotation element reference.
    Note
    Creo Parametric must regenerate the model after making the indicated changes to the annotation element.
    Use the method wfcSelect.WSelection.SetAnnotationInAnnotationElement to modify the annotation contained in an annotation element. Pass the input argument Annotation as NULL to modify the annotation element to be a non-graphical annotation.
    Note
    The above method 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 methods wfcSelect.WSelection.GetAutoPropagateFlagInAnnotationElement and wfcSelect.WSelection.SetAutoPropagateFlagInAnnotationElement get and set the autopropagate flag of the specified annotation element reference.
    The method wfcSelect.WSelection.AddAnnotationReferenceInAnnotationElement adds a strong user-defined reference to the annotation element.
    The method wfcSelect.WSelection.SetAnnotationReferencesInAnnotationElement replaces all the user-defined references in the annotation element with references that are specified in the input argument Reference.
    The method wfcSelect.WSelection.RemoveAnnotationReferenceInAnnotationElement removes the user-defined reference from the annotation element.
    The method wfcSelect.WSelection.SetAnnotationElementReferences sets user-defined annotation references in the specified annotation elements. The input arguments follow:
    •  Elements—Annotation Elements specified using the class wfcAnnotation.AnnotationElements.
    •  References—User-defined references specified using the class wfcAnnotation.AnnotationReferenceSetsArray.
    •  InvokeUI—Specify the Boolean value to indicate whether the UI is invoked.
    Use the method wfcAnnotation.wfcAnnotation.AnnotationReferenceSet_Create to create an instance of the wfcAnnotationReferenceSet object. The input arguments are as follows:
    •  Reference
    •  Strong
    •  Description
    •  AutoPropagate
    Use the methods wfcAnnotation.AnnotationReferenceSet.GetReference and wfcAnnotation.AnnotationReferenceSet.SetReference to get and set the user-defined annotation references using the wfcAnnotation.AnnotationReference object.
    Use the methods wfcAnnotation.AnnotationReferenceSet.GetStrong and wfcAnnotation.AnnotationReferenceSet.SetStrong to get and set the strength of the user-defined annotation references.
    Use the methods wfcAnnotation.AnnotationReferenceSet.GetDescription and wfcAnnotation.AnnotationReferenceSet.SetDescription to get and set the description of the user-defined annotation references.
    Use the methods wfcAnnotation.AnnotationReferenceSet.GetAutoPropagate and wfcAnnotation.AnnotationReferenceSet.SetAutoPropagate to get and set auto propagate flag for the user-defined annotation features.
    The method wfcSelect.WSelection.StrengthenAnnotationElementReference converts a weak reference to a strong reference.
    The method wfcSelect.WSelection.WeakenAnnotationElementReference converts a strong reference to a weak reference.
    The method wfcAnnotation.AnnotationReferenceCurveCollectionObject_Create creates a curve collection object for the specified user-defined annotation references.
    The methods wfcAnnotation.AnnotationReferenceCurveCollectionObject.GetCurveCollection and wfcAnnotation.AnnotationReferenceCurveCollectionObject.SetCurveCollection retrieves and sets the curve collections for the user-defined set of annotation references using the wfcCollection.Collection object.
    The method wfcAnnotation.AnnotationReferenceSelectionObject_Create creates a selection object for the specified user-defined annotation references.
    The methods wfcAnnotation.AnnotationReferenceSelectionObject.GetReference and wfcAnnotation.AnnotationReferenceSelectionObject.SetReference retrieves and sets the references for the user-defined annotation references using the pfcSelect.Selection object.
    The method wfcAnnotation.AnnotationReferenceSurfaceCollectionObject_Create creates a surface collection object for the specified user-defined annotation references.
    The methods wfcAnnotation.AnnotationReferenceSurfaceCollectionObject.GetSurfaceCollection and wfcAnnotation.AnnotationReferenceSurfaceCollectionObject.SetSurfaceCollection retrieves and sets the surface collections for the user-defined annotation references using the wfcCollection.Collection object.
    Accessing Reference and Driven Dimensions
    Methods Introduced:
  • wfcSolid.WSolid.CreateDimension
    		•
    The method wfcWSolid.Solid.CreateDimension creates a new driven dimension. Specify the geometric references and parameters required to construct the required dimension as the input parameters for this method. Once the reference dimension is created, use the method wfcAnotation.Annotation.ShowInDrawing to display it. The input arguments of this method are as follows:
    •  AnnotPlane—Specifies the annotation plane for the dimensions.
    •  DimAttachs—Specifies the points on the model where you want to attach the dimension.
    Note
    The attachments structure is an array of two pfcSelection entities. It is provided to support options such as intersect where two entities must be passed as input. From Creo Parametric 3.0 onward, you can create dimensions that have intersection type of reference. The intersection type of reference is a reference that is derived from the intersection of two entities. Refer to the Creo Parametric Detailed Drawings Help for more information on intersection type of reference.
    •  Senses—Specifies more information about how the dimension attaches to each attachment point of the model, that is, to what part of the entity.
    •  OrientHint—Specifies the orientation of the dimension and has one of the following values:
    ○  pfcORIENTATION_HINT_HORIZONTAL—Specifies a horizontal dimension.
    ○  pfcORIENTATION_HINT_VERTICAL—Specifies a vertical dimension.
    ○  pfcORIENTATION_HINT_SLANTED—Specifies the shortest distance between two attachment points (available only when the dimension is attached to points).
    ○  pfcORIENTATION_HINT_ELLIPSE_RADIUS1—Specifies the start radius for a dimension on an ellipse.
    ○  pfcORIENTATION_HINT_ELLIPSE_RADIUS2—Specifies the end radius for a dimension on an ellipse.
    ○  pfcORIENTATION_HINT_ARC_ANGLE—Specifies the angle of the arc for a dimension of an arc.
    ○  pfcORIENTATION_HINT_ARC_LENGTH—Specifies the length of the arc for a dimension of an arc.
    ○  pfcORIENTATION_HINT_LINE_TO_TANGENT_CURVE_ANGLE—Specifies the value to dimension the angle between the line and the tangent at a curve point (the point on the curve must be an endpoint).
    ○  pfcORIENTATION_HINT_RADIAL_DIFF—Specifies the linear dimension of the radial distance between two concentric arcs or circles.
    •  Location—Specifies the initial location of the dimension text.
    Automatic Propagation of Annotation Elements
    Automatic local propagation of annotation elements can be done based on some specified conditions, using a Creo TOOLKIT application.
    When an appropriate event occurs during a Creo Parametric session, the associated notification method can invoke a local propagation.
    Methods Introduced:
  • wfcSession.WSession.AutoPropagate
    		•
    The method wfcSession.WSession.AutoPropagate causes the local and automatic propagation of annotation elements to the currently selected feature within the same model, after a supported feature has either been created or modified. The propagation behavior is dependant on the standard Creo Parametric algorithm and on the current contents of the selection buffer.
    Following are the list of supported features:
    •  Draft
    ○  Surface
    ○  Solid
    •  Offset
    ○  Surface
    ○  With Draft
    ○  Expand
    •  Mirror Surface
    •  Copy Surface
    •  Move Surface
    The Creo TOOLKIT application can be written so as to specify the condition for the automatic propagation, based on created feature-type, subtype or any other required properties.
    The method propagates based on the current contents of the selection buffer.
    Note
    The method wfcSession.WSession.AutoPropagate works regardless of the current value for the configuration option, auto_propagate_ae. PTC advises that the Creo TOOLKIT application respect the current value of this configuration option; otherwise, duplicate versions of the propagated annotations can result.
    Detail Tree
    Methods introduced:
  • wfcSolid.WSolid.CollapseDetailTree
    		•
  • wfcSolid.WSolid.ExpandDetailTree
    		•
  • wfcSolid.WSolid.RefreshDetailTree
    		•
    Use the method wfcSolid.WSolid.CollapseDetailTree to collapse all nodes of the detail tree in the Creo Parametric window and make its child nodes invisible.
    Use the method wfcSolid.WSolid.ExpandDetailTree to expand the detail tree in the Creo Parametricwindow.
    Use the method wfcSolid.WSolid.RefreshDetailTree to rebuild the detail tree in the Creo Parametric window that contains the model.
    The input argument for the above three methods is SolidWindow. It is the window containing the solid. By default, the detail tree in the active window is used.
    Converting Annotations to Latest Version
    Methods Introduced:
  • wfcAnnotation.Annotation.NeedsConversion
    		•
  • wfcAnnotation.Annotation.ConvertLegacy
    		•
    The method wfcAnnotation.Annotation.NeedsConversion returns true in the following cases:
    •  Annotations created in releases earlier than Creo Parametric 4.0 F000
    •  Annotations created using the deprecated methods ProGtolCreate() or ProSetdatumtagCreate()
    The method wfcAnnotation.Annotation.ConvertLegacy converts annotations to the latest Creo Parametric version.
    You can call the method wfcAnnotation.Annotation.ConvertLegacy only if the method wfcAnnotation.Annotation.NeedsConversion returns true.
    Annotation Text Styles
    Methods Introduced:
  • wfcAnnotation.Annotation.GetTextStyle
    		•
  • wfcAnnotation.Annotation.SetTextStyle
    		•
  • wfcAnnotation.Annotation.GetTextStyleInDrawing
    		•
  • wfcAnnotation.Annotation.SetTextStyleInDrawing
    		•
  • pfcDetail.pfcDetail.AnnotationTextStyle_Create
    		•
  • pfcDetail.AnnotationTextStyle.GetAngle
    		•
  • pfcDetail.AnnotationTextStyle.SetAngle
    		•
  • pfcDetail.AnnotationTextStyle.GetColor
    		•
  • pfcDetail.AnnotationTextStyle.SetColor
    		•
  • pfcDetail.AnnotationTextStyle.GetFont
    		•
  • pfcDetail.AnnotationTextStyle.SetFont
    		•
  • pfcDetail.AnnotationTextStyle.GetHeight
    		•
  • pfcDetail.AnnotationTextStyle.SetHeight
    		•
  • pfcDetail.AnnotationTextStyle.GetWidth
    		•
  • pfcDetail.AnnotationTextStyle.SetWidth
    		•
  • pfcDetail.AnnotationTextStyle.GetThickness
    		•
  • pfcDetail.AnnotationTextStyle.SetThickness
    		•
  • pfcDetail.AnnotationTextStyle.GetHorizontalJustification
    		•
  • pfcDetail.AnnotationTextStyle.SetHorizontalJustification
    		•
  • pfcDetail.AnnotationTextStyle.GetVerticalJustification
    		•
  • pfcDetail.AnnotationTextStyle.SetVerticalJustification
    		•
  • pfcDetail.AnnotationTextStyle.GetSlantAngle
    		•
  • pfcDetail.AnnotationTextStyle.SetSlantAngle
    		•
  • pfcDetail.AnnotationTextStyle.IsHeightInModelUnits
    		•
  • pfcDetail.AnnotationTextStyle.SetHeightInModelUnits
    		•
  • pfcDetail.AnnotationTextStyle.IsTextMirrored
    		•
  • pfcDetail.AnnotationTextStyle.MirrorText
    		•
  • pfcDetail.AnnotationTextStyle.IsTextUnderlined
    		•
  • pfcDetail.AnnotationTextStyle.UnderlineText
    		•
    The methods wfcAnnotation.Annotation.GetTextStyle and wfcAnnotation.Annotation.SetTextStyle retrieve and set the text style for the specified annotation as a pfcDetail.AnnotationTextStyle object.
    The method wfcAnnotation.Annotation.GetTextStyleInDrawing retrieves the text style for the specified annotation in a drawing as a pfcDetail.AnnotationTextStyle object. The input arguments are:
    •  Drawing—Specifies a drawing only when the annotation is owned by the solid, but is displayed in the drawing.
    •  CompPath—Specifies the component path to the solid that owns the annotation as a pfcAssembly.ComponentPath object.
    •  View—This is reserved for future use. Pass NULL.
    The method wfcAnnotation.Annotation.SetTextStyleInDrawing sets the text style for the specified annotation in a drawing.
    The method pfcDetail.pfcDetail.AnnotationTextStyle_Create creates a data object that contains information about text style for a specified annotation.
    The methods pfcDetail.AnnotationTextStyle.GetAngle and pfcDetail.AnnotationTextStyle.SetAngle get and set the angle of the text style.
    The methods pfcDetail.AnnotationTextStyle.GetColor and pfcDetail.AnnotationTextStyle.SetColor retrieve and set the color of the text style as a pfcBase.ColorRGB object.
    The methods pfcDetail.AnnotationTextStyle.GetFont and pfcDetail.AnnotationTextStyle.SetFont get and set the font of the text.
    The methods pfcDetail.AnnotationTextStyle.GetHeight and pfcDetail.AnnotationTextStyle.SetHeight get and set the height of the text style.
    The methods pfcDetail.AnnotationTextStyle.GetWidth and pfcDetail.AnnotationTextStyle.SetWidth retrieve and set the width of the text style.
    The methods pfcDetail.AnnotationTextStyle.GetThickness and pfcDetail.AnnotationTextStyle.SetThickness get and set the thickness of the text style.
    The methods pfcDetail.AnnotationTextStyle.GetHorizontalJustification and pfcDetail.AnnotationTextStyle.SetHorizontalJustification get and set the horizontal justification of the text style using the enumerated data type pfcDetail.HorizontalJustification. The valid values are:
    •  H_JUSTIFY_LEFT—Aligns the text style object to the left.
    •  H_JUSTIFY_CENTER—Aligns the text style object in the center.
    •  H_JUSTIFY_RIGHT—Aligns the text style object to the right.
    •  H_JUSTIFY_DEFAULT—Aligns the text using the default justification. The justification selected for the first note becomes the default for all successive notes added during the current session.
    The methods pfcDetail.AnnotationTextStyle.GetVerticalJustification and pfcDetail.AnnotationTextStyle.SetVerticalJustification get and set the vertical justification of the text style using the enumerated data type pfcDetail.VerticalJustification. The valid values are:
    •  V_JUSTIFY_TOP—Aligns the text style object to the top.
    •  V_JUSTIFY_MIDDLE—Aligns the text style object to the middle.
    •  V_JUSTIFY_BOTTOM—Aligns the text style object to the bottom.
    •  V_JUSTIFY_DEFAULT—Aligns the text using the default justification. The justification selected for the first note becomes the default for all successive notes added during the current session.
    The methods pfcDetail.AnnotationTextStyle.GetSlantAngle and pfcDetail.AnnotationTextStyle.SetSlantAngle get and set the slant angle of the text style.
    The method pfcDetail.AnnotationTextStyle.IsHeightInModelUnits checks if the text height is in relation to the model units or as a fraction of the screen size. This method is applicable for flat-to-screen annotations only.
    The methods pfcDetail.AnnotationTextStyle.IsTextMirrored checks if the text style is mirrored.
    The methods pfcDetail.AnnotationTextStyle.MirrorText specifies the option to mirror the text style. Specify the input argument Mirror to true to mirror the text style.
    The methods pfcDetail.AnnotationTextStyle.IsTextUnderlined checks if the text style is underlined.
    The methods pfcDetail.AnnotationTextStyle.UnderlineText specifies the option to underline the text style
    Annotation Orientation
    An annotation orientation refers to the annotation plane or the parallel plane in which the annotation lies, the viewing direction, and the text rotation. You can define the annotation orientation using a datum plane or flat surface, a named view, or as flat to screen. If the orientation is defined by a datum plane, you can set its reference to frozen or driven; where frozen indicates that the reference to the datum plane or named view has been removed.
    Methods Introduced:
  • wfcAnnotation.Annotation.Rotate
    		•
  • wfcSelect.WSelection.CreateAnnotationPlane
    		•
  • wfcSolid.WSolid.CreateAnnotationPlaneFromView
    		•
  • wfcSolid.WSolid.CreateFlatToScreenPlane
    		•
  • wfcAnnotation.AnnotationPlane.GetReference
    		•
  • wfcAnnotation.AnnotationPlane.GetPlaneData
    		•
  • wfcAnnotation.AnnotationPlane.GetFlip
    		•
  • wfcAnnotation.AnnotationPlane.GetNormalVector
    		•
  • wfcAnnotation.AnnotationPlane.GetViewName
    		•
  • wfcAnnotation.AnnotationPlane.GetPlaneType
    		•
  • wfcAnnotation.AnnotationPlane.IsFrozen
    		•
  • wfcAnnotation.AnnotationPlane.SetFrozen
    		•
  • wfcAnnotation.AnnotationPlane.IsForceToPlane
    		•
  • wfcAnnotation.AnnotationPlane.SetForceToPlane
    		•
  • wfcAnnotation.AnnotationPlane.GetPlaneAngle
    		•
  • wfcAnnotation.AnnotationPlane.GetPlaneOrientation
    		•
  • wfcAnnotation.AnnotationPlane.GetNames
    		•
  • wfcAnnotation.AnnotationPlane.AssignName
    		•
  • wfcModel.WModel.GetAnnotationPlanesFromGallery
    		•
  • wfcModel.WModel.GetAnnotationPlanes
    		•
  • wfcModel.WModel.GetAnnotationPlaneByName
    		•
  • wfcModel.WModel.AddAnnotationPlaneToGallery
    		•
  • wfcModel.WModel.RemoveAnnotationPlaneFromGallery
    		•
  • wfcModel.WModel.GetActiveAnnotationPlane
    		•
    The method wfcAnnotaion.Annotation.Rotate rotates a given annotation by the specified angle. This moves the annotation to a new annotation plane with the appropriate rotation assigned. Other annotations on the annotation’s current plane are unaffected by this method.
    Note
    You can only rotate annotations that belong to annotation elements using the above method.
    The method wfcSelect.WSelection.CreateAnnotationPlane creates a new annotation plane from either a datum plane, a flat surface, or an existing annotation that already contains an annotation plane .
    The method wfcSolid.WSolid.CreateAnnotationPlaneFromView creates a new annotation plane from a saved model view .
    The method wfcSolid.WSolid.CreateFlatToScreenPlane returns an annotation plane representing a flat-to-screen annotation in the model . This method takes a boolean input argument ScreenOrMdlPoint, which identifies whether the annotations on this plane are located by screen points, or by model units.
    The method wfcAnnotation.AnnotationPlane.GetReference returns the planar surface used as the annotation plane.
    The method wfcAnnotation.AnnotationPlane.GetPlaneData returns the geometry of the annotation plane, the origin and orientation of the annotation plane as a wfcGeometry.WPlaneData object.
    The method wfcAnnotation.AnnotationPlane.GetFlip specifies if the annotation plane was flipped during creation.
    The method wfcAnnotation.AnnotationPlane.GetNormalVector returns the normal vector that determines the viewing direction of the annotation plane .
    The method wfcAnnotation.AnnotationPlane.GetViewName obtains the name of the view that was originally used to determine the orientation of the annotation plane.
    Note
    If the named view orientation has been changed after the annotation plane was created, the orientation of the plane will not match the current orientation of the view.
    Use the method wfcAnnotation.AnnotationPlane.GetPlaneType to obtain the annotation plane type. the valid values of the enumerated data type wfcAnnotation.AnnotationPlaneType:
    •  ANNOTATION_PLANE_REFERENCE—The annotation plane is created from a datum plane or a flat surface, and can be frozen or be associative to the reference.
    •  ANNOTATION_PLANE_NAMED_VIEW—The annotation plane is created from a named view or a view in the drawing.
    •  ANNOTATION_PLANE_FLATTOSCREEN_BY_MODELPNT—The annotation plane is flat-to-screen and annotations are located by model units.
    •  ANNOTATION_PLANE_FLATTOSCREEN_BY_SCREENPNT—The annotation plane is flat-to-screen and annotations are located by screen points.
    •  ANNOTATION_PLANE_FLATTOSCREEN_LEGACY—The annotation uses a legacy flat-to-screen format (located in model space).
    The methods wfcAnnotation.AnnotationPlane.IsFrozen and wfcAnnotation.AnnotationPlane.SetFrozen determine and assign, respectively, whether the annotation orientation is frozen or driven by reference to the plane geometry. These methods are applicable only for annotation planes governed by references.
    The methods wfcAnnotation.AnnotationPlane.IsForceToPlane and wfcAnnotation.AnnotationPlane.SetForceToPlane check and assign, respectively, the boolean value of the argument ForceToPlane for an annotation plane. If this argument is set to true, then the annotations that reference the annotation plane are placed on that plane. If the annotation orientation is not frozen, that is, driven by the reference plane, and if the reference plane is moved, then the annotations also move along with the plane.
    The method wfcAnnotation.AnnotationPlane.GetPlaneAngle returns the current rotation angle in degrees for a given annotation plane.
    The method wfcAnnotation.AnnotationPlane.GetPlaneOrientation returns the text orientation of all annotations on that plane.
    The method wfcAnnotation.AnnotationPlane.GetNames returns the names of the annotation plane.
    The method wfcAnnotation.AnnotationPlane.AssignName assigns a name to the specified annotation plane.
    The method wfcModel.WModel.GetAnnotationPlanesFromGallery collects the names of all the annotation planes in the gallery.
    The method wfcModel.WModel.GetAnnotationPlanes collects the names of all the named annotation planes in the specified model.
    The method wfcModel.WModel.GetAnnotationPlaneByName finds and returns the annotation plane with the specified name.
    Use the method wfcModel.WModel.AddAnnotationPlaneToGallery to add an annotation plane with the specified name to the gallery.
    Use the method wfcModel.WModel.RemoveAnnotationPlaneFromGallery to remove the annotation plane with the specified name from the gallery.
    The method wfcModel.WModel.GetActiveAnnotationPlane returns the active annotation plane in the specified model.
    Accessing Baseline and Ordinate Dimensions
    The methods described in this section enable you to create 3D ordinate driven dimensions in 3D models as model annotations or as annotation elements. They also provide the ability to define a baseline annotation element, and then define model ordinate dimension annotations and ordinate dimension annotation elements that reference the baseline annotation element.
    Baseline Dimensions
    Methods Introduced:
  • wfcDimension.WDimension.IsBaseline
    		•
  • wfcDimension.WDimension.GetBaselineDimension
    		•
  • wfcSelect.WSelection.CreateAnnotationFeatBaseline
    		•
    The method wfcDimension.WDimension.IsBaseline identifies whether a dimension is a baseline dimension.
    The method wfcDimension.WDimension.GetBaselineDimension obtains the baseline dimension in a drawing.
    The method wfcSelect.WSelection.CreateAnnotationFeatBaseline creates an ordinate baseline annotation element and corresponding dimension as a wfcAnnotation.AnnotationElement object. The input arguments are:
    •  Reference—Specifies the reference geometry for the ordinate baseline dimension as a pfcSelect.Selection object.
    •  Plane—Specifies the annotation plane for the baseline dimension and all its related dimensions as a wfcAnnotation.AnnotationPlane. Refer to the section Annotation Orientation for more information on the wfcAnnotation.AnnotationPlane object.
    •  DirReference—Specifies the direction of the dimension witness lines.
    Ordinate Dimensions
    Methods Introduced:
  • wfcDimension.WDimension.IsOrdinate
    		•
  • wfcDimension.WDimension.GetOrdinateStandard
    		•
  • wfcDimension.WDimension.SetOrdinateStandard
    		•
  • wfcDimension.WDimension.SetOrdinateReferences
    		•
  • wfcDrawing.WDrawing.CreateAutoOrdinateDimensions
    		•
  • wfcDimension.WDimension.OrdinateDimensionToLinear
    		•
  • wfcDimension.WDimension.LinearDimensionToOrdinate
    		•
    The method wfcDimension.WDimension.IsOrdinate identifies if a dimension is ordinate.
    The method wfcDimension.WDimension.GetOrdinateStandard returns the display standard for the ordinate dimensions in the drawing using the enumerated type wfcDimension.DimOrdinateStandard. The valid values for display standards are as follows:
    •  DIM_ORDSTD_DEFAULT—Specifies the default style for the ordinate dimensions.
    •  DIM_ORDSTD_ANSI—Specifies the American National Standard style for the ordinate dimension. It places the related ordinate dimensions without a connecting line.
    •  DIM_ORDSTD_JIS—Specifies the Japanese Industrial Standard style for the ordinate dimension. It places the ordinate dimensions along a connecting line that is perpendicular to the baseline and starts with an open circle.
    •  DIM_ORDSTD_ISO—Specifies the International Standard of Organization style for the ordinate dimension.
    •  DIM_ORDSTD_DIN—Specifies the German Institute for Standardization style for the ordinate dimension.
    •  DIM_ORDSTD_SAME_AS_3D—Specifies the ordinate dimension style for 2D drawings. Not used in 3D ordinate dimensions.
    The method wfcDimension.WDimension.SetOrdinateStandard sets the style for the specified ordinate dimension or a set of ordinate dimensions.
    Use the method wfcDimension.WDimension.SetOrdinateReferences to set the dimension attachments and dimension senses.
    The method wfcDrawing.WDrawing.CreateAutoOrdinateDimensions creates ordinate dimensions automatically for the selected surfaces. The input arguments are:
    •  Surfaces—Specifies a set of parallel surfaces for which the ordinate dimensions must be created as a pfcSelect.Selections object.
    •  Baseline—Specifies a reference element used to create the baseline dimension as a pfcSelect.Selection object. The reference element can be an edge, a curve, or a datum plane.
    The method wfcDimension.WDimension.OrdinateDimensionToLinear converts an existing ordinate dimension to a linear dimension in a solid.
    The method wfcDimension.WDimension.LinearDimensionToOrdinate converts a linear dimension to an ordinate dimension.
    Note
    The dimension must be first created as an ordinate dimension and then converted to a linear dimension. This method does not work on dimensions which were first created as linear dimensions.
    Annotation Associativity
    The methods described in this section allow you to ensure associativity between shown annotations in drawings and 3D models. You can independently control the position associativity and attachment associativity of a drawing annotation.
    Note
    •  Drawing annotations can have only uni-directional associativity, that is, changes to the position and attachment of the annotation in the 3D model are reflected for the annotation in the drawing view, but not vice-versa.
    •  You cannot modify the position associativity and attachment associativity of a drawing annotation from the 3D model.
    •  You cannot make free, flat-to-screen annotations in a drawing view associative to the annotations in the 3D model.
    •  Annotation properties such as text, jogs, breaks, skew, witness line clippings, and flip arrow states are not associative.
    Methods Introduced:
  • wfcAnnotation.Annotation.IsAssociative
    		•
  • wfcAnnotation.Annotation.GetAttachmentAssociativity
    		•
  • wfcAnnotation.Annotation.UpdatePosition
    		•
  • wfcAnnotation.Annotation.UpdateAttachment
    		•
    The method wfcAnnotation.Annotation.IsAssociative checks if a given annotation in a drawing view is associative to the annotation in the 3D model.
    The method wfcAnnotation.Annotation.GetAttachmentAssociativity retrieves the associativity of the attachment using the enumerated data type wfcAnnotation.AnnotationAttachmentAssociativity. The valid values are as follows:
    •  ANNOTATTACH_ASSOCIATIVITY_NONE—Specifies that the drawing annotation is not associative.
    •  ANNOTATTACH_ASSOCIATIVITY_PARTIAL—Specifies that the drawing annotation is partially associative.
    •  ANNOTATTACH_ASSOCIATIVITY_FULL— Specifies that the drawing annotation is fully associative.
    The method wfcAnnotation.Annotation.UpdatePosition updates the position of the drawing annotation, and makes it associative to the position of the annotation in the 3D model.
    Note
    You can update the associative position only for drawing annotations that have their placement based on model coordinates.
    The method wfcAnnotation.Annotation.UpdateAttachment updates the attachment of the drawing annotation, and makes it associative to the attachment of the annotation in the 3D model. Associative attachment of an annotation refers to both – its references and its attachment point on its references. t.
    Note
    You can update the associative attachment only for drawing annotations that are attached to the geometry.
    Annotation Security
    The methods described in this section allow you to manage whether an annotation is designated as a security marking.
    Methods Introduced:
  • wfcAnnotation.Annotation.SetSecurityMarking
    		•
  • wfcAnnotation.Annotation.GetSecurityMarking
    		•
    Use the method wfcAnnotation.Annotation.SetSecurityMarking to set the security marking option for notes and symbols.
    Use the method wfcAnnotation.Annotation.GetSecurityMarking to retrieve the security marking option for notes and symbols.
    Accessing Set Datum Tags
    The methods described in this section provide the ability to access and display set datum tag annotations in 3D models.
    Methods Introduced:
  • wfcAnnotation.SetDatumTag.GetAttachment
    		•
  • wfcAnnotation.SetDatumTag.SetAttachment
    		•
  • wfcAnnotation.SetDatumTag.GetAnnotationPlane
    		•
  • wfcAnnotation.SetDatumTag.SetAnnotationPlane
    		•
  • wfcAnnotation.SetDatumTag.Show
    		•
  • wfcAnnotation.SetDatumTag.Delete
    		•
  • wfcAnnotation.SetDatumTag.GetAdditionalText
    		•
  • wfcAnnotation.SetDatumTag.SetAdditionalText
    		•
  • wfcSetDatumTagAdditionalText.GetPosition
    		•
  • wfcSetDatumTagAdditionalText.SetPosition
    		•
  • wfcSetDatumTagAdditionalText.GetText
    		•
  • wfcSetDatumTagAdditionalText.SetText
    		•
  • wfcAnnotation.SetDatumTag.GetAdditionalTextLocation
    		•
  • wfcAnnotation.SetDatumTag.GetTextLocation
    		•
  • wfcAnnotation.SetDatumTag.IsShownInDrawingView
    		•
  • wfcAnnotation.SetDatumTag.EraseFromDrawingView
    		•
  • wfcAnnotation.SetDatumTag.GetDimGTolDisplay
    		•
  • wfcAnnotation.SetDatumTag.SetLabel
    		•
  • wfcAnnotation.SetDatumTag.GetLabel
    		•
  • wfcAnnotation.SetDatumTag.SetASMEDisplay
    		•
  • wfcAnnotation.SetDatumTag.GetASMEDisplay
    		•
  • wfcAnnotation.SetDatumTag.SetElbow
    		•
  • wfcAnnotation.SetDatumTag.GetElbow
    		•
  • wfcAnnotation.SetDatumTag.GetPlacement
    		•
  • wfcAnnotation.SetDatumTag.DeleteReference
    		•
  • wfcAnnotation.SetDatumTag.GetReferences
    		•
  • wfcAnnotation.SetDatumTag.AddReferences
    		•
  • wfcModel.WModel.CreateSetDatumTag
    		•
  • wfcModel.WModel.ListSetDatumTags
    		•
    The methods wfcAnnotation.SetDatumTag.GetAttachment and wfcAnnotation.SetDatumTag.SetAttachment get and set the item on which the datum tag .
    Note
    To specify the datum plane or datum axis as the attachment option, pass the input argument Reference as NULL in the method wfcAnnotation.SetDatumTag.SetAttachment. The datum tag is attached to the datum axis at the default location.
    The methods wfcAnnotation.SetDatumTag.GetAnnotationPlane and wfcAnnotation.SetDatumTag.SetAnnotationPlane get and set the annotation plane for the specified set datum tag .
    Once the set datum tag annotation is created, use the method wfcAnnotation.SetDatumTag.Show to display it.
    Use the method wfcAnnotation.SetDatumTag.Delete to delete the specified datum feature tag annotation.
    The methods wfcAnnotation.SetDatumTag.GetAdditionalText and wfcAnnotation.SetDatumTag.SetAdditionalText get and set the additional text for the specified datum feature tag.
    The methods wfcAnnotation.SetDatumTagAdditionalText.GetPosition and wfcAnnotation.SetDatumTagAdditionalText.SetPosition to get and set the position of the additional text around the frame of the datum feature tag. You can set the position of the additional text using the enumerated data type wfcAnnotation.SetDatumTagAdditionalTextPos and the valid values are:
    •  SDT_ADDL_TEXT_RIGHT
    •  SDT_ADDL_TEXT_BOTTOM
    •  SDT_ADDL_TEXT_LEFT
    •  SDT_ADDL_TEXT_TOP
    •  SDT_ADDL_TEXT_DEFAULT
    The methods wfcAnnotation.SetDatumTagAdditionalText.GetText and wfcAnnotation.SetDatumTagAdditionalText.SetText to get and set the additional text around the frame of the datum feature tag.
    The method wfcAnnotation.SetDatumTag.GetAdditionalTextLocation retrieves the location of additional text for the specified datum feature tag.
    The method wfcAnnotation.SetDatumTag.GetTextLocation retrieves the text point for the specified datum feature tag.
    The method wfcAnnotation.SetDatumTag.IsShownInDrawingView returns the display status of the set datum tag in the specified view of a drawing.
    Use the method wfcAnnotation.SetDatumTag.EraseFromDrawingView to set a set datum tag to be erased from the specified view of a drawing. The annotation is not displayed until it is explicitly displayed using the method wfcAnnotation.SetDatumTag.IsShownInDrawingView.
    The method wfcAnnotation.SetDatumTag.GetDimGTolDisplay
    Use the methods wfcAnnotation.SetDatumTag.SetLabel and wfcAnnotation.SetDatumTag.GetLabel to get and set the label for the specified datum feature tag annotation
    The method wfcAnnotation.SetDatumTag.SetASMEDisplay displays the datum feature tag annotation according to the ASME standard.
    Use the method wfcAnnotation.SetDatumTag.GetASMEDisplay to check if the specified datum feature tag annotation is displayed as per ASME standard.
    The method wfcAnnotation.SetDatumTag.SetElbow sets or unset Elbow to datum feature tag annotation.
    Use the method wfcAnnotation.SetDatumTag.GetElbow to check if a specified datum feature tag annotation Elbow is set.
    The method wfcAnnotation.SetDatumTag.GetPlacement returns the item type, id, and owner on which the set datum tag is placed. Use this method in cases where it is not possible to construct the selection. For example, when the solid owned datum feature tag is attached to a solid owned dimension that is created in a drawing.
    Use the method wfcAnnotation.SetDatumTag.DeleteReference to delete semantic references in the specified datum feature tag. The references are specified by their index number.
    Use the method wfcAnnotation.SetDatumTag.GetReferences to retrieve semantic references in the specified datum feature tag.
    The method wfcAnnotation.SetDatumTag.AddReferences adds semantic references to the specified datum feature tag.
    The method wfcModel.WModel.CreateSetDatumTag create a new set datum tag annotation. The input arguments follow:
    •  Selection—
    •  Label—The label for the datum feature tag.
    •  Plane—Plane for the annotation.
    The method wfcModel.WModel.ListSetDatumTags enables you to visit the set datum tag annotations in the specified drawing.
    Designating Dimensions and Symbols
    Methods Introduced:
  • wfcModel.WModel.DesignateSymbol
    		•
  • wfcModel.WModel.IsDesignatedSymbol
    		•
  • wfcModel.WModel.UndesignateSymbol
    		•
    The method wfcModel.WModel.DesignateSymbol designates a dimension, dimension tolerance, geometric tolerance or surface finish symbol to the specified model.
    The method wfcModel.WModel.IsDesignatedSymbol determines if a dimension, dimension tolerance, geometric tolerance or surface finish symbol has been designated to a model.
    The method wfcModel.WModel.UndesignateSymbol undesignates the dimension, dimension tolerance, geometric tolerance or surface finish symbol from the specified model.
    Surface Finish Annotations
    The methods described in this section provide read access to the properties of the surface finish object. They also allow you to create and modify surface finishes.
    The style of surface finishes for releases previous to Pro/ENGINEER Wildfire 2.0 was a flat-to-screen symbol attached to a single surface. From Pro/ENGINEER Wildfire 2.0 onwards, the method for construction of surface finishes has been modified. The new style of surface finish is a symbol instance that may be attached on a surface or with a leader. The following methods support both the old and new surface finish annotations, except where specified.
    Methods Introduced:
  • wfcAnnotation.SurfaceFinish.GetValue
    		•
  • wfcAnnotation.SurfaceFinish.SetValue
    		•
  • wfcAnnotation.SurfaceFinish.GetReferences
    		•
  • wfcAnnotation.SurfaceFinish.GetSurfaceCollection
    		•
  • wfcAnnotation.SurfaceFinish.SetSurfaceCollection
    		•
  • wfcAnnotation.SurfaceFinish.Modify
    		•
  • wfcAnnotation.SurfaceFinish.GetSymbolInstructions
    		•
  • wfcAnnotation.SurfaceFinish.Delete
    		•
  • wfcAnnotation.SurfaceFinish.Show
    		•
  • wfcModel.WModel.CreateSurfaceFinish
    		•
    The methods wfcAnnotation.SurfaceFinish.GetValue and wfcAnnotation.SurfaceFinish.SetValue get and set the value of a surface finish annotation.
    The method wfcAnnotation.SurfaceFinish.GetReferences returns the surface or surfaces referenced by the surface finish.
    The method wfcAnnotation.SurfaceFinish.GetSurfaceCollection obtains a surface collection which contains the references of the surface finish .
    The method wfcAnnotation.SurfaceFinish.GetSurfaceCollection assigns a surface collection to be the references of the surface finish. This overwrites all current surface finish references. The following types of surface collections are supported:
    •  One by one surface set
    •  Intent surface set
    •  Excluded surface set
    •  Seed and Boundary surface set
    •  Loop surface set
    •  Solid surface set
    •  Quilt surface set
    The method wfcAnnotation.SurfaceFinish.Modify modifies the symbol instance data for the specified surface finish. This method supports new symbol-based surface finishes only.
    The method wfcAnnotation.SurfaceFinish.GetSymbolInstructions returns the symbol instance data for the surface finish
    The method wfcAnnotation.SurfaceFinish.Delete deletes the specified surface finish.
    Once the surface finish annotation is created, use the method wfcAnnotation.SurfaceFinish.Show to display it.
    The method wfcModel.WModel.CreateSurfaceFinish creates a new symbol-based surface finish annotation. The method requires a symbol instance data structure for creation. Once the surface finish annotation is created, use the method wfcAnnotation.Annotation.ShowInDrawing to display it.
    Symbol Annotations
    The methods described in this section provide support for 3D mode symbols. Creo Object TOOLKIT C++methods for symbol instances are used in both 2D and 3D modes. Symbols for a particular mode must conform to the requirements for that mode.
    Creating, Reading and Modifying 3D Symbols
    Methods Introduced:
  • wfcDetail.WDetailSymbolInstItem.GetAnnotationPlane
    		•
  • wfcDetail.WDetailSymbolInstItem.SetAnnotationPlane
    		•
    The methods wfcDetail.WDetailSymbolInstItem.GetAnnotationPlane and wfcDetail.WDetailSymbolInstItem.SetAnnotationPlane retrieve and set the annotation plane for 3D symbol data . Annotation planes are required for 3D symbol instances but are not applicable for 2D symbol instances.
    Locating and Collecting 3D Symbols and Symbol Definitions
    Methods Introduced:
  • wfcDetail.WDetailSymbolDefItem.VisitNotes
    		•
  • wfcDetail.WDetailSymbolDefItem.VisitEntities
    		•
  • wfcSolid.WSolid.RetrieveSymbolDefItem
    		•
    The method wfcDetail.WDetailSymbolDefItem.VisitNotes visits the notes contained in a symbol definition stored in a solid model or a drawing.
    The method wfcDetail.WDetailSymbolDefItem.VisitEntities visits the entities contained in a symbol definition stored in a solid model.
    The method wfcSolid.WSolid.RetrieveSymbolDefItem allows retrieval of a symbol definition into a given solid model. The input arguments for this method are as follows:
    •  FileName— The name of the symbol definition file.
    •  Source — The location to search for the symbol definition file.
    •  FilePath— The path to the file with a symbol definition. If not given, then the symbol definition is located in the designated directory.
    •  Version— The version of the symbol definition file. Pass -1 to get the latest version.
    •  UpdateUnconditionally— Update flag.
    ○  xtrue - Update the existing symbol definition unconditionally.
    ○  xfalse- Do not load new definition if the same symbol exist in the drawing.
    Notes
    The methods in this section enable you to access the notes created in Creo.
    Note
    These methods are applicable to solids (parts and assemblies) only.
    Note Properties
    Methods Introduced:
  • wfcDetail.WDetailNoteItem.GetGTol
    		•
  • wfcDetail.WDetailNoteItem.GetElbowDirection
    		•
  • wfcDetail.WDetailNoteItem.GetLeaderStyle
    		•
  • wfcDetail.WDetailNoteItem.SetLeaderStyle
    		•
  • wfcDetail.WDetailNoteItem.Get3DLineEnvelope
    		•
  • wfcDetail.WDetailNoteItem.GetLegacyLeaderNoteLength
    		•
  • wfcDetail.WDetailNoteItem.GetLegacyLeaderNoteDirection
    		•
    The method wfcDetail.WDetailNoteItem.GetGTol returns the detail note that represents a shown geometric tolerance.
    The method wfcDetail.WDetailNoteItem.GetElbowDirection retrieves the direction of elbow in a note in model coordinate system . For flat-to-screen notes, the method retrieves the elbow direction in the screen coordinate system.
    The methods wfcDetail.WDetailNoteItem.GetLeaderStyle and wfcDetail.WDetailNoteItem.SetLeaderStyle retrieve and set the leader style used for the note. The valid values of the leader style are specified by the enumerated data type wfcAnnotation.LeaderStyle:
    •  LEADER_STYLE_STANDARD—Specifies that the leader style used for the note is standard.
    •  LEADER_STYLE_ISO—Specifies that the leader style used for the note is ISO.
    The method wfcDetail.WDetailNoteItem.Get3DLineEnvelope retrieves the envelope of a line for a specified note .
    The method wfcDetail.WDetailNoteItem.GetLegacyLeaderNoteLength retrieves the length of a leader line in a note .
    The method wfcDetail.WDetailNoteItem.GetLegacyLeaderNoteDirection retrieves the direction of a leader line in a note .
    Note
    Creoadds hard line breaks to the multiple lines drawing notes created in Creo Elements/Pro during retrieval. The hard line breaks display the text of the note on separate lines in the Note Properties dialog box as they actually appear in the drawing note.
    Accessing Note Placement
    The methods described in this section provide access to the properties of a 3D note.
    Methods Introduced:
  • wfcDetail.WDetailNoteItem.GetLeaderArrowTypes
    		•
  • wfcDetail.WDetailNoteItem.GetAnnotationPlane
    		•
    The method wfcDetail.WDetailNoteItem.GetLeaderArrowTypes retrieves the type of arrowhead used for leaders attached to note .
    The method wfcDetail.WDetailNoteItem.GetAnnotationPlane retrieves the annotation plane assigned to the note attachment data .
    Modifying 3D Note Attachments
    The actual note created in Creo Parametric will not be modified until the note attachment is assigned to the note.
    Methods Introduced:
  • wfcDetail.WDetailNoteItem.AddLeader
    		•
  • wfcDetail.WDetailNoteItem.AddLeaderWithArrowType
    		•
  • pfcDetail.DetailLeaderAttachment.GetLeaderAttachment
    		•
  • pfcDetail.DetailLeaderAttachment.SetLeaderAttachment
    		•
  • pfcDetail.DetailLeaderAttachment.GetType
    		•
  • wfcDetail.WDetailNoteItem.SetLeadersWithArrowType
    		•
  • wfcDetail.WDetailNoteItem.RemoveLeader
    		•
  • wfcDetail.WDetailNoteItem.SetAnnotationPlane
    		•
  • wfcSolid.WSolid.CreateOnItemNote
    		•
  • wfcSolid.WSolid.CreateFreeNote
    		•
    The method wfcDetail.WDetailNoteItem.AddLeader adds a new leader to the end of the array of current leaders on a note. .
    Use the method wfcDetail.WDetailNoteItem.AddLeaderWithArrowType to add a new leader to the end of the array of current leaders on a note . The method takes as input a DetailLeaderAttachment object and the type of arrowhead to be used for the leader.
    The methods pfcDetail.DetailLeaderAttachment.GetLeaderAttachment and pfcDetail.DetailLeaderAttachment.SetLeaderAttachment retrieve and set the leader attachment as a pfcDetail.Attachment object.
    The method pfcDetail.DetailLeaderAttachment.GetType retrieves the type of attachment using the enumerated data type pfcDetail.DetailLeaderAttachmentType. It determines the precise attachment point for the note leader.
    The valid values are:
    •  LEADER_ATTACH_NONE—Specifies regular leader attachment.
    •  LEADER_ATTACH_NORMAL—Specifies a normal attachment.
    •  LEADER_ATTACH_TANGENT—Specifies a tangent attachment.
    The method wfcDetail.WDetailNoteItem.SetLeadersWithArrowType sets a new leader to the end of the array of current leaders on a note and specifies the type of arrowhead that is to be used for the attached leader.
    The method wfcDetail.WDetailNoteItem.RemoveLeader removes a leader from the note .
    The method wfcDetail.WDetailNoteItem.SetAnnotationPlane sets the annotation plane for the note..
    The method wfcSolid.WSolid.CreateOnItemNote sets the location of an "On Item" note placement. Using this method removes any leaders currently assigned to the note attachment.
    The method wfcSolid.WSolid.CreateFreeNote sets the location of the note text. The input arguments to this method are TextLines and Attach. The note text is stored in relative model coordinates, where {0.5, 0.5, 0.5} indicates the exact center of the model's display bounding box obtained from wfcWSolid.WSolid.GetDisplayOutline, and {0.0, 0.0, 0.0} and {1.0, 1.0, 1.0} represent the corners of the box.
    Text Style Properties
    Methods Introduced:
  • pfcbase.TextStyle.GetAngle
    		•
  • pfcbase.TextStyle.SetAngle
    		•
  • pfcbase.TextStyle.GetFontName
    		•
  • pfcbase.TextStyle.SetFontName
    		•
  • pfcbase.TextStyle.GetHeight
    		•
  • pfcbase.TextStyle.SetHeight
    		•
  • pfcbase.TextStyle.GetIsMirrored
    		•
  • pfcbase.TextStyle.SetIsMirrored
    		•
  • pfcbase.TextStyle.GetSlantAngle
    		•
  • pfcbase.TextStyle.SetSlantAngle
    		•
  • pfcbase.TextStyle.GetThickness
    		•
  • pfcbase.TextStyle.SetThickness
    		•
  • pfcbase.TextStyle.GetWidthFactor
    		•
  • pfcbase.TextStyle.SetWidthFactor
    		•
  • pfcbase.TextStyle.GetIsUnderlined
    		•
  • pfcbase.TextStyle.SetIsUnderlined
    		•
    The functions pfcbase.TextStyle.GetAngle and pfcbase.TextStyle.SetAngle get and set the angle of rotation for the text style object.. If you do not call pfcbase.TextStyle.SetAngle when creating the text style, the rotation defaults to 0.0.
    The methods pfcbase.TextStyle.GetFontName and pfcbase.TextStyle.SetFontName get and set the font used to display the text style object.
    The methods pfcbase.TextStyle.GetHeight and pfcbase.TextStyle.SetHeight get and set the height of the text style object. The value -1.0 means that the text has the default height for text currently specified for the drawing.
    The methods pfcbase.TextStyle.GetIsMirrored and pfcbase.TextStyle.SetIsMirrored get and set the mirroring option specified for the text style object.
    The methods pfcbase.TextStyle.GetSlantAngle and pfcbase.TextStyle.SetSlantAngle get and set the slant angle of the text style object.
    The methods pfcbase.TextStyle.GetThickness and pfcbase.TextStyle.SetThickness get and set the line thickness of the text style object. The value -1.0 means that the text has the default thickness for text currently specified for the drawing.
    The methods pfcbase.TextStyle.GetWidthFactor and pfcbase.TextStyle.SetWidthFactor get and set the width factor of the text style object. The width factor is the ratio of the width of each character to the height. The value -1.0 means that the width factor has the default value for text currently specified for the drawing.
    The methods pfcbase.TextStyle.GetIsUnderlined and pfcbase.TextStyle.SetIsUnderlined get and set the underline option for the text style object.