AddByElement Method

Description

Creates a DatumPoint object.

Syntax

Visual Basic
Public Function AddByElement( _ ByVal TerminatorObject As Object, _ ByVal x1 As Double, _ ByVal y1 As Double, _ ByVal z1 As Double, _ ByVal keyPoint1 As Boolean _ ) As DatumPoint

Parameters

TerminatorObject: Specifies the object on which the datum point is to be placed.
x1: Specifies the coordinates of the datum point.
y1: Specifies the coordinates of the datum point.
z1: Specifies the coordinates of the datum point.
keyPoint1: Specifies whether the object or a key point of the object is to be considered for measuring. If True, the element is selected for the centerline's end point; if False, the nearest key point is selected.

Remarks

If the DatumPoint object is placed with respect to a key point, the point of reference is the key point.

Example

Example (Visual Basic)

Private Sub Form_Load()
    Dim objApp As SolidEdgeFrameWork.Application
    Dim objDoc As SolidEdgeDraft.DraftDocument
    Dim objSheet As SolidEdgeDraft.Sheet
    Dim objDatumPoints As SolidEdgeFrameworkSupport.DatumPoints
    Dim objDatumPoint As SolidEdgeFrameworkSupport.DatumPoint
    Dim objLine As SolidEdgeFrameworkSupport.Line2d
    ' 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
    'Get the Active Sheet object
    Set objSheet = objDoc.ActiveSheet
    'get datumpoints collection
    Set objDatumPoints = objSheet.DatumPoints
    ' Create a Line object
    Set objLine = objSheet.Lines2d.AddBy2Points(x1:=0.2, y1:=0.1, _
                                                x2:=0.3, y2:=0.1)
    'create a DatumPoint by AddByElement method
    Set objDatumPoint = objDatumPoints.AddByElement(TerminatorObject:= _
                                                    objLine, x1:=0.23, y1:=0.2, z1:=0, Keypoint1:=True)
    ' USER DISPLAY
    ' Release objects
    Set objApp = Nothing
    Set objDoc = Nothing
    Set objSheet = Nothing
    Set objDatumPoints = Nothing
    Set objDatumPoint = Nothing
    Set objLine = Nothing
End Sub