GetTerminator Method

Description

Returns the object to which the terminal end of a dimensioning or annotation object's leader connects.

Syntax

Visual Basic
Public Sub GetTerminator( _ ByRef TerminatorObj As Object, _ ByRef x As Double, _ ByRef y As Double, _ ByRef z As Double, _ ByRef keyPoint As Boolean _ )

Parameters

TerminatorObj: Specifies the object to which the terminal end of a dimensioning or annotation object's leader connects.
x: Coordinates of the leader's terminal connect point on the TerminatorObj.
y: Coordinates of the leader's terminal connect point on the TerminatorObj.
z: Coordinates of the leader's terminal connect point on the TerminatorObj.
keyPoint: Returns True if the leader was placed with respect to the TerminatorObj. Returns False if the leader was placed with respect to a key point on the TerminatorObj.

Remarks

This method also returns the coordinates of the leader's terminal connect point and a Boolean value to indicate whether the leader was placed with respect to the object or with respect to a key point on that object.

Example

Example (Visual Basic)

Private Sub Form_Load()
    Dim objApp As SolidEdgeFrameWork.Application
    Dim objDoc As SolidEdgeDraft.DraftDocument
    Dim objSheet As SolidEdgeDraft.Sheet
    Dim objDatumTargets As SolidEdgeFrameworkSupport.DatumTargets
    Dim objDatumTarget As SolidEdgeFrameworkSupport.DatumTarget
    Dim objLine As SolidEdgeFrameworkSupport.Line2d
    Dim objLine1 As Object, dblX As Double, dblY As Double
    Dim dblZ As Double, bKeyPoint As Boolean
    ' Report errors
    Const PI = 3.14159265358979
    ' Create/get the application with specific settings
    On Error Resume Next
    Set objApp = GetObject(, "SolidEdge.Application")
    If Err Then
        Err.Clear
        Set objApp = CreateObject("SolidEdge.Application")
        Set objDoc = objApp.Documents.Add("SolidEdge.DraftDocument")
        objApp.Visible = True
    Else
        Set objDoc = objApp.ActiveDocument
    End If
    'getting the Active Sheet object
    Set objSheet = objDoc.ActiveSheet
    'Create a Line2d
    Set objLine = objSheet.Lines2d.AddBy2Points(x1:=0.25, y1:=0.25, x2:=0.45, y2:=0.25)
    'Getting the DatumTargets object
    Set objDatumTargets = objSheet.DatumTargets
    'Create a Datum target in the active sheet with AddByTerminator to line
    Set objDatumTarget = objDatumTargets.AddByTerminator(TerminatorObject:=objLine, _
                                                         x1:=0.25, y1:=0.25, z1:=0, keypoint1:=False)
    'Add a Text to the Datum Target
    objDatumTarget.DatumReference = "A"
    'Get the Terminator of Datumtarget
    Call objDatumTarget.GetTerminator(TerminatorObj:=objLine1, x:=dblX, y:=dblY, _
                                      z:=dblZ, keypoint:=bKeyPoint)
    ' USER DISPLAY
    ' Release objects
    Set objApp = Nothing
    Set objDoc = Nothing
    Set objSheet = Nothing
    Set objDatumTargets = Nothing
    Set objDatumTarget = Nothing
    Set objLine = Nothing
End Sub