Methods Introduced:
The method wfcGTol::GetGTolAttach retrieves all the attachment related information for a gtol using the class wfcGTolAttach.
The method
wfcGTolAttach::GetType retrieves the type of attachment for a specified gtol. It uses the enumerated data type
wfcGTolAttachType to provide information about the placement of the gtol and has one of the following values:
|
• |
wfcGTOLATTACH_DATUM—Specifies that the gtol is placed on its reference datum. |
|
• |
wfcGTOLATTACH_ANNOTATION—Specifies that the gtol is attached to an annotation. |
|
• |
wfcGTOLATTACH_ANNOTATION_ELBOW—Specifies that the gtol is attached to the elbow of an annotation. |
|
• |
wfcGTOLATTACH_FREE—Specifies that the gtol is placed as free. It is unattached to the model or drawing. |
|
• |
wfcGTOLATTACH_LEADERS—Specifies that the gtol is attached with one or more leader to geometry such as, edge, dimension witness line, coordinate
system, axis center, axis lines, curves, or surface points, vertices, section entities, draft entities, and so on. The leaders
are represented using an opaque handle, wfcGTolAttachLeader. |
|
• |
wfcGTOLATTACH_OFFSET—Specifies that the gtol frame can be placed at an offset from the following drawing objects: dimension, dimension arrow,
gtol, note, and symbol. |
|
• |
wfcGTOLATTACH_MAKE_DIM—Specifies that the gtol frame is attached to a dimension line. |
Use the method wfcGTol::SetAttachFree to set the attachment options for free type of gtol. The input argument Attach is specified using the class wfcGTolAttachFree.
Use the method
wfcGTolAttachFree::Create to create an attachment for a gtol that is placed free. The input arguments are:
|
• |
Location—Specifies the location of the gtol text in model coordinates. |
|
• |
AnnotationPlane—Specifies the annotation plane in model coordinates. |
Use the methods wfcGTolAttachFree::GetLocation and wfcGTolAttachFree::SetLocation to get and set the location of the gtol text in a specified gtol using the class pfcPoint3D.
Use the methods wfcGTolAttachFree::GetAnnotationPlane and wfcGTolAttachFree::SetAnnotationPlane to get and set the annotation plane in a specified gtol using the class wfcAnnotationPlane.
Use the method wfcGTol::SetAttachLeader to set the attachment options for leader type of gtol. The input argument Attach is specified using the class wfcGTolAttachLeader.
Use the method
wfcGTolAttachLeader::Create to create an attachment for leader type of gtol. The input arguments are:
|
• |
LeaderAttachType—Specifies the attachment type for the leader. |
|
• |
Leaders—Specifies a sequence of gtol leaders. |
|
• |
Location—Specifies the location of gtol text in model coordinates. |
|
• |
AnnotationPlane—Specifies the annotation plane. For gtols defined in drawing, it returns NULL. |
Use the methods wfcGTolAttachLeader::GetLocation and wfcGTolAttachLeader::SetLocation to get and set the location of the gtol text in a specified gtol using the class pfcPoint3D.
Use the methods wfcGTolAttachLeader::GetLeaders and wfcGTolAttachLeader::SetLeaders to get and set the leaders in a specified gtol using the class wfcGTolLeaderInstructionsSeq.
Use the methods
wfcGTolAttachLeader::GetLeaderAttachType and
wfcGTolAttachLeader::SetLeaderAttachType to get and set the type of leaders that can be attached in a specified gtol. The type of leaders is specified using the enumerated
type
wfcGTolLeaderAttachType and one of the valid values are:
Use the methods wfcGTolAttachLeader::GetAnnotationPlane and wfcGTolAttachLeader::SetAnnotationPlane to get and set the annotation plane on which the leader is attached to the specified gtol. The plane is specified using the
class wfcAnnotationPlane.
Use the method wfcGTolAttachLeader::GetMissingLeaders to get the number of suppressed leaders due to missing references.
Use the method wfcGTolLeaderInstructions::Create to create instructions for a leader type of gtol.
The methods wfcGTolLeaderInstructions::GetSelection and wfcGTolLeaderInstructions::SetSelection get and set the selection of instructions for a leader type of gtol using the class pfcSelection.
The methods wfcGTolLeaderInstructions::GetType and wfcGTolLeaderInstructions::SetType get and set the type of instructions for a leader type of gtol.
The method wfcGTolLeaderInstructions::GetIsZExtension checks if the gtol leader has a Z-Extension line.
The method wfcGTolLeaderInstructions::GetZExtensionPoint retrieves the Z-Extension line of the gtol leader. The leader location coordinates are required when the gtol is moved to
a different annotation plane.
Use the method wfcGTol::SetAttachDatum to set the attachment options for datum symbol type of gtol. The input argument Attach is specified using the class wfcGTolAttachDatum.
Use the method wfcGTolAttachDatum::Create to create an attachment for a specified datum inside a gtol. The input argument Datum is specified using the pfcModelItem class.
The methods wfcGTolAttachDatum::GetDatum and wfcGTolAttachDatum::SetDatum get and set the attachments for datum type of gtol.
From Creo Parametric 4.0 F000 onward, datum symbols are defined using datum feature symbol. The methods work with the new datum feature symbol along with
the legacy datum tag annotations.
Use the method wfcGTol::SetAttachAnnotation to set the attachment options for annotation type of gtol. The input argument Attach is specified using the class wfcGTolAttachAnnotation.
Use the method wfcGTolAttachAnnotation::Create to create an attachment for a specified annotation inside a gtol. The input argument Annotation is specified using the wfcAnnotation class.
The methods wfcGTolAttachAnnotation::GetAnnotation and wfcGTolAttachAnnotation::SetAnnotation get and set the attachments for annotation type of gtol.
Use the method wfcGTol::SetAttachOffset to set the offset references for the geometric tolerance. The input argument Attach is specified using the class wfcGTolAttachOffset.
Use the method
wfcGTolAttachOffset::Create to create an attachment for a gtol with offset references. The input arguments are:
|
• |
OffsetRef—Specifies the offset reference. |
|
• |
Offset—Specifies the position of the offset reference as model coordinates. |
The methods wfcGTolAttachOffset::GetOffset and wfcGTolAttachOffset::SetOffset get and set the position of the offset reference as model coordinates using the class pfcVector3D.
The methods wfcGTolAttachOffset::GetOffsetRef and wfcGTolAttachOffset::SetOffsetRef get and set the offset reference using the class pfcSelection. The reference can be a dimension, arrow of a dimension, another geometric tolerance, note, or a symbol instance. If there
are no offset references, the output argument returns NULL.
Use the method wfcGTol::SetAttachMakeDimension to set all the attachments options to create a geometric tolerance with Make Dim type of reference. The input argument Attach is specified using the class wfcGTolAttachMakeDimension.
Use the method wfcGTolAttachMakeDimension::Create to create an attachment for a gtol with Make Dim type of reference.
Use the methods wfcGTolAttachMakeDimension::GetLocation and wfcGTolAttachMakeDimension::SetLocation to get and set the location of the gtol text in a specified gtol using the class pfcPoint3D.
Use the methods
wfcGTolAttachMakeDimension::GetOrientHint and
wfcGTolAttachMakeDimension::SetOrientHint to get and set the orientation of the gtol using the enumerated type
pfcDimOrientationHint and one of the valid values are:
|
• |
pfcORIENTATION_HINT_HORIZONTAL |
|
• |
pfcORIENTATION_HINT_VERTICAL |
|
• |
pfcORIENTATION_HINT_SLANTED |
|
• |
pfcORIENTATION_HINT_ELLIPSE_RADIUS1 |
|
• |
pfcORIENTATION_HINT_ELLIPSE_RADIUS2 |
|
• |
pfcORIENTATION_HINT_ARC_ANGLE |
|
• |
pfcORIENTATION_HINT_ARC_LENGTH |
|
• |
pfcORIENTATION_HINT_LINE_TO_TANGENT_CURVE_ANGLE |
|
• |
pfcORIENTATION_HINT_RADIAL_DIFF |
Use the methods wfcGTolAttachMakeDimension::GetDimSenses and wfcGTolAttachMakeDimension::SetDimSenses to get and set the information about how the gtol attaches to each attachment point of the model or drawing. The input argument
value is specified using the class pfcDimSenses.
Use the methods wfcGTolAttachMakeDimension::GetDimAttachments and wfcGTolAttachMakeDimension::SetDimAttachments to get and set the points on the model or drawing where the gtol is attached. The input argument value is specified using the class pfcDimensionAttachments.
Use the methods wfcGTolAttachMakeDimension::GetAnnotationPlane and wfcGTolAttachMakeDimension::SetAnnotationPlane to get and set the annotation plane in a specified gtol using the class wfcAnnotationPlane.