Class wfcAnnotation
# include <wfcAnnotation.h>
class wfcAnnotation
: public virtual wfcLayerItem,
: public virtual wfcWModelItem
{
xaideclare(wfcAnnotation)
...
};
Description
This interface represent various type of annotations such as Dimension,Note,Symbols,SetDatumTag,Surface Finish.
Direct Known Subclasses:
wfcSetDatumTag, wfcSurfaceFinish, wfcGTol, wfcWDetailNoteItem, wfcWDetailSymbolInstItem, wfcWTable, wfcWDimension
User Guide References:
Annotation Features and Annotations:wfcAnnotation, Ordinate Dimensions:wfcAnnotation, Combined States of a Solid:wfcAnnotation, Creating Annotation Features:wfcAnnotation, Redefining Annotation Features:wfcAnnotation, Accessing Annotations:wfcAnnotation, Accessing and Modifying Annotation Elements:wfcAnnotation, Accessing Reference and Driven Dimensions:wfcAnnotation, Converting Annotations to Latest Version:wfcAnnotation, Annotation Text Styles:wfcAnnotation, Annotation Orientation:wfcAnnotation, Baseline Dimensions:wfcAnnotation, Annotation Associativity:wfcAnnotation, Annotation Security:wfcAnnotation, Accessing Set Datum Tags:wfcAnnotation, Surface Finish Annotations:wfcAnnotation, Attaching the Geometric Tolerances:wfcAnnotation
Methods Inherited from Class wfcLayerItem::
Methods Inherited from Class pfcActionSource::
Methods Inherited from Class pfcParent::
Methods Inherited from Class pfcParameterOwner::
Methods Inherited from Class wfcWParameterOwner::
Methods Inherited from Class pfcRelationOwner::
Methods Inherited from Class wfcWRelationOwner::
Methods Inherited from Class pfcChild::
Methods Inherited from Class pfcModelItem::
Methods Inherited from Class wfcWModelItem::
Method Summary
void | |
Converts annotation created before Creo 4.0 or created using deprecated APIs ProGtolCreate or ProSetdatumtagCreate. | |
void | Display () |
Displays annotation which is temporarily undisplayed by wfcAnnotation::Undisplay(). This method must be called after making changes in an annotation. | |
void | DisplayInDrawing (pfcDrawing_ptr DrawingModel, cipOptional pfcView2D_ptr DrawingView, cipOptional pfcComponentPath_ptr CompPath) |
Displays annotation owned by solid and shown in drawing which is temporarily undisplayed by wfcAnnotation::Undisplay(). This method must be called after making changes in an annotation. | |
LICENSE: 222 | |
LICENSE: 222 | |
GetDesignate () | |
Get the designate type of the annotation. | |
Get all offset symbol instances associated with the annotation. | |
Check if child annotation inherits references from parent. | |
Gets Security Marking option for Notes and Symbols | |
GetTextStyle () | |
LICENSE: 222 Get textstyle information of annotation. | |
GetTextStyleInDrawing (pfcDrawing_ptr Drawing, cipOptional pfcComponentPath_ptr CompPath, cipOptional pfcView2D_ptr View) | |
LICENSE: 222 Get textstyle information of annotation in specified drawing. | |
LICENSE: 222 | |
IsInactive () | |
LICENSE: 222 | |
Checks if specified reference is an inherited annotation reference. | |
Checks if annotation is shown in owner or specified drawing. | |
Identifies if the annotation is created on or attached to a cross-sectional edge. | |
Returns if the annotation is created before Creo 4.0 or is created using deprecated APIs ProGtolCreate or ProSetdatumtagCreate and needs conversion. Call wfcAnnotation::ConvertLegacy() only if this API returns true. | |
void | |
LICENSE: 222 | |
void | |
Sets the annotation as designate with specified type. | |
void | |
Set if child annotation can inherit references from parent. | |
void | |
Gets Security Marking option for Notes and Symbols | |
void | |
LICENSE: 222 Get textstyle information of annotation. | |
void | SetTextStyleInDrawing (pfcAnnotationTextStyle_ptr TextStyle, pfcDrawing_ptr Drawing, cipOptional pfcComponentPath_ptr CompPath, cipOptional pfcView2D_ptr View) |
LICENSE: 222 Set textstyle information of annotation in specified drawing. | |
void | |
Show annotation owned by solid in a drawing. | |
void | Undisplay () |
Undisplays annotation temporarily. This method must be called before making any changes in an annotation. | |
void | |
Undisplays annotation owned by solid and shown in drawing temporarily. This method must be called before making any changes in an annotation. | |
void | |
Updates the display of the annotation, but does not actually display it anywhere. If the annotation is not currently displayed (because its hidden by layer status or inactive geometry) the text extracted from the annotation with mode pfcDIM_DISPLAY_NUMERIC may include callout symbols instead of the text shown to the user. This method will tell Creo Parametric to update the contents of the annotation to cross-reference these callout values. | |
void | |
LICENSE: 222 Updates the attachment of the drawing annotation and makes it associative to the attachment of the annotation in the 3D model. | |
void | |
LICENSE: 222 Updates the position of the drawing annotation and makes it associative to the position of the annotation in the 3D model. |
Method Detail
void | ShowInDrawing |
Show annotation owned by solid in a drawing.
Exceptions thrown (but not limited to):
pfcXToolkitNoChange - The annotation is already shown in the target model.
pfcXToolkitInvalidMatrix - The annotation cannot be shown due to orientation conflicts in the view.
pfcXToolkitNoLicense - License check failure.
pfcXToolkitNotDisplayed - Annotation is present on hidden or blank layer and so can't be shown.
User Guide References:
Parameters:
DrawingView
A drawing view where annotation will be shown.
CompPath
Component path for solid owner.
Returns:
void | Display | () |
Displays annotation which is temporarily undisplayed by wfcAnnotation::Undisplay(). This method must be called after making changes in an annotation.
Exceptions thrown (but not limited to):
pfcXToolkitInvalidMatrix - The annotation cannot be shown due to orientation conflicts in theview.
pfcXToolkitNoLicense - License check failure.
pfcXToolkitNotDisplayed - Annotation is present on hidden or blank layer and so can't be shown.
User Guide References:
Returns:
void | DisplayInDrawing | (pfcDrawing_ptr DrawingModel, cipOptional pfcView2D_ptr DrawingView, cipOptional pfcComponentPath_ptr CompPath) |
Displays annotation owned by solid and shown in drawing which is temporarily undisplayed by wfcAnnotation::Undisplay(). This method must be called after making changes in an annotation.
Exceptions thrown (but not limited to):
pfcXToolkitInvalidMatrix - The annotation cannot be shown due to orientation conflicts in theview.
pfcXToolkitNoLicense - License check failure.
pfcXToolkitNotDisplayed - Annotation is present on hidden or blank layer and so can't be shown.
User Guide References:
Parameters:
DrawingModel
Drawing where annotation is shown.
DrawingView
Drawing view where annotation is temporarily displayed. Pass null to toggle in existing view.
CompPath
Component path of solid owner.
Returns:
void | Undisplay | () |
Undisplays annotation temporarily. This method must be called before making any changes in an annotation.
Exceptions thrown (but not limited to):
pfcXToolkitNoLicense - License check failure.
User Guide References:
Returns:
void | UndisplayInDrawing |
Undisplays annotation owned by solid and shown in drawing temporarily. This method must be called before making any changes in an annotation.
Exceptions thrown (but not limited to):
pfcXToolkitNoLicense - License check failure.
User Guide References:
Parameters:
DrawingModel
Drawing view where annotation is shown.
CompPath
Component path of solid owner.
Returns:
IsShown |
Checks if annotation is shown in owner or specified drawing.
Exceptions thrown (but not limited to):
pfcXToolkitNoLicense - License check failure.
Parameters:
DrawingModel
Drawing.
Returns:
void | Update |
Updates the display of the annotation, but does not actually display it anywhere. If the annotation is not currently displayed (because its hidden by layer status or inactive geometry) the text extracted from the annotation with mode pfcDIM_DISPLAY_NUMERIC may include callout symbols instead of the text shown to the user. This method will tell Creo Parametric to update the contents of the annotation to cross-reference these callout values.
This method currently supports '3D model notes' and 'detail notes' only.
User Guide References:
Parameters:
DrawingModel
The drawing where it is to be displayed. Pass null if the owner of the annotation is the same as the model where it would be displayed.
Returns:
GetTextStyle | () |
LICENSE: 222
Get textstyle information of annotation.
Exceptions thrown (but not limited to):
pfcXToolkitNotFound - No shown version of annotation was found in the drawing
pfcXToolkitAmbiguous - Multiple shown versions of the annotation were found with different text styles.
User Guide References:
Returns:
TextStyle.
void | SetTextStyle |
LICENSE: 222
Get textstyle information of annotation.
Exceptions thrown (but not limited to):
pfcXToolkitNotFound - No shown version of annotation was found in the drawing
User Guide References:
Parameters:
TextStyle
TextStyle
Returns:
GetTextStyleInDrawing |
LICENSE: 222
Get textstyle information of annotation in specified drawing.
Exceptions thrown (but not limited to):
pfcXToolkitNotFound - No shown version of annotation was found in the drawing
pfcXToolkitAmbiguous - Multiple shown versions of the annotation were found with different text styles.
User Guide References:
Parameters:
Drawing
Drawing.
CompPath
Component path of owner solid.
View
Reserved for future expansion. Pass null.
Returns:
TextStyle
void | SetTextStyleInDrawing | (pfcAnnotationTextStyle_ptr TextStyle, pfcDrawing_ptr Drawing, cipOptional pfcComponentPath_ptr CompPath, cipOptional pfcView2D_ptr View) |
LICENSE: 222
Set textstyle information of annotation in specified drawing.
Exceptions thrown (but not limited to):
pfcXToolkitNotFound - No shown version of annotation was found in the drawing
User Guide References:
Parameters:
TextStyle
TextStyle.
Drawing
Drawing.
CompPath
Component path of owner solid.
View
Reserved for future expansion. Pass null.
Returns:
void | UpdateAttachment |
LICENSE: 222
Updates the attachment of the drawing annotation and makes it associative to the attachment of the annotation in the 3D model.
Exceptions thrown (but not limited to):
pfcXToolkitNotFound - The annotation is not shown in the drawing.
User Guide References:
Parameters:
Drawing
The drawing
Returns:
void | UpdatePosition |
LICENSE: 222
Updates the position of the drawing annotation and makes it associative to the position of the annotation in the 3D model.
Exceptions thrown (but not limited to):
pfcXToolkitNotFound - The annotation is not shown in the drawing.
User Guide References:
Parameters:
Drawing
The drawing
Returns:
IsAssociative |
LICENSE: 222
Exceptions thrown (but not limited to):
pfcXToolkitNotFound - The annotation is not shown in the drawing.
User Guide References:
Parameters:
Drawing
Returns:
GetAttachmentAssociativity |
LICENSE: 222
Exceptions thrown (but not limited to):
pfcXToolkitNotFound - The annotation is not shown in the drawing.
User Guide References:
Parameters:
Drawing
Returns:
GetAnnotationElement | () |
LICENSE: 222
Exceptions thrown (but not limited to):
pfcXToolkitNotFound - The annotation is not contained in any annotation element.
pfcXToolkitNotExist - The annotation element owner of the annotation does not exist.
User Guide References:
Returns:
IsInactive | () |
LICENSE: 222
Exceptions thrown (but not limited to):
pfcXToolkitNoLicense - License check failure.
User Guide References:
Returns:
void | Rotate |
LICENSE: 222
Exceptions thrown (but not limited to):
pfcXToolkitBadContext - The annotation does not support assigned rotation angles.
pfcXToolkitCantWrite - Could not modify the given item because it has read-only access.
User Guide References:
Parameters:
Angle
Returns:
void | ConvertLegacy | () |
Converts annotation created before Creo 4.0 or created using deprecated APIs ProGtolCreate or ProSetdatumtagCreate.
Exceptions thrown (but not limited to):
pfcXToolkitNoChange - The annotation is not legacy.
User Guide References:
Returns:
NeedsConversion | () |
Returns if the annotation is created before Creo 4.0 or is created using deprecated APIs ProGtolCreate or ProSetdatumtagCreate and needs conversion. Call wfcAnnotation::ConvertLegacy() only if this API returns true.
User Guide References:
Returns:
TRUE if the annotation needs conversion FALSE if the annotation is already converted
GetSecurityMarking | () |
Gets Security Marking option for Notes and Symbols
User Guide References:
Returns:
If true then specified annotation is marked for security check
void | SetSecurityMarking |
Gets Security Marking option for Notes and Symbols
User Guide References:
Parameters:
Marking
True if the annotation refers a cross-section geometry.
Returns:
IsUsingXSecReference | () |
Identifies if the annotation is created on or attached to a cross-sectional edge.
User Guide References:
Returns:
True if the annotation refers a cross-section geometry.
GetOffsetSymbols |
Get all offset symbol instances associated with the annotation.
Exceptions thrown (but not limited to):
pfcXToolkitBadInputs - The input argument is invalid.
pfcXToolkitNotFound - No symbols found.
Parameters:
Drawing
Top drawing where symbols exist.
Returns:
Array of associated symbol instances.
User Guide References:
void | SetDesignate |
Sets the annotation as designate with specified type.
Exceptions thrown (but not limited to):
pfcXToolkitBadInputs - One or more input arguments was invalid.
Parameters:
Designate
The designate type to set.
Returns:
User Guide References:
GetDesignate | () |
Get the designate type of the annotation.
Exceptions thrown (but not limited to):
pfcXToolkitNotFound - The annotation is not in an annotation element.
Returns:
The designate type.
User Guide References:
GetReferencesInherit | () |
Check if child annotation inherits references from parent.
Exceptions thrown (but not limited to):
pfcXToolkitInvalidType - Annotation is not a child annotation.
pfcXToolkitBadInputs - One or more input arguments was invalid.
pfcXToolkitBadContext - Child annotation not supported to inherit references.
Returns:
True if child annotation inherits references.
User Guide References:
void | SetReferencesInherit |
Set if child annotation can inherit references from parent.
Exceptions thrown (but not limited to):
pfcXToolkitInvalidType - Annotation is not a child annotation.
pfcXToolkitBadInputs - One or more input arguments was invalid.
pfcXToolkitBadContext - Child annotation not supported to inherit references.
Parameters:
Inherit
True to inherit references from parent.
Returns:
User Guide References:
IsReferenceInherited |
Checks if specified reference is an inherited annotation reference.
Exceptions thrown (but not limited to):
pfcXToolkitInvalidType - Annotation is not a child annotation.
pfcXToolkitBadInputs - One or more input arguments was invalid.
pfcXToolkitBadContext - Child annotation not supported to inherit references.
Parameters:
Reference
The annotation reference to check.
Returns:
True if the reference is inherited.
User Guide References: