SolidWorksMakroprogrammierung

Objekt · SldWorks

DatumOrigin-Objekt

Der Bezugspunkt einer Bohrungstabelle in einer Zeichnung: das Ursprungssymbol mit den Beschriftungen seiner X- und Y-Achse, seine Form und die Bohrungstabelle dazu.

Deklaration Dim x As SldWorks.DatumOrigin · in der englischen .NET-Hilfe: IDatumOrigin

Beschreibung

DatumOrigin gibt Zugriff auf die Beschriftung eines Bezugspunkts (datum origin). Eine Bohrungstabelle misst die Lage ihrer Bohrungen von diesem Bezugspunkt aus. In der Zeichenansicht steht er als Ursprungssymbol mit zwei Pfeilen für die X- und die Y-Achse. Die Befehle gibt es seit SOLIDWORKS 2004, DatumOrigin.GetAxisPoints2 seit SOLIDWORKS 2005 SP01.

Zugriff

Beispiel

' Gibt für jeden Bezugspunkt der aktiven Zeichenansicht die Achsbeschriftungen,
' die Bohrungstabelle und die Spitzen der beiden Pfeile aus.
' Vorbedingung: Eine Zeichnung mit einer Bohrungstabelle ist offen, die Zeichenansicht
'               mit dem Bezugspunkt ist aktiv.
' Ergebnis:     Die Werte stehen im Direktfenster, die Zeichnung bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDraw As SldWorks.DrawingDoc
    Dim swView As SldWorks.View
    Dim swUrsprung As SldWorks.DatumOrigin
    Dim swBohrTab As SldWorks.HoleTable
    Dim vPunkte As Variant

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then Exit Sub
    Set swDraw = swModel
    Set swView = swDraw.ActiveDrawingView
    If swView Is Nothing Then Exit Sub

    Set swUrsprung = swView.GetFirstDatumOrigin
    Do While Not swUrsprung Is Nothing
        Debug.Print swUrsprung.GetAnnotation.GetName & ": X """ & swUrsprung.XLabel & """, Y """ & swUrsprung.YLabel & """"
        Set swBohrTab = swUrsprung.Table
        If Not swBohrTab Is Nothing Then Debug.Print "  Bohrungstabelle: " & swBohrTab.GetFeature.Name
        vPunkte = swUrsprung.GetAxisPoints2
        If IsArray(vPunkte) Then
            Debug.Print "  Pfeilspitze X: " & Round(vPunkte(2) * 1000, 2) & " / " & Round(vPunkte(3) * 1000, 2) & " mm"
            Debug.Print "  Pfeilspitze Y: " & Round(vPunkte(6) * 1000, 2) & " / " & Round(vPunkte(7) * 1000, 2) & " mm"
        End If
        Set swUrsprung = swUrsprung.GetNext
    Loop
End Sub

Bemerkungen

Hilfebeispiel: „Get Labels of Datum Origin“ öffnet ein Teil, legt eine Zeichnung an, wählt eine Ecke mit Markierung 1 als Bezugspunkt und eine Fläche mit Markierung 2 und fügt eine Bohrungstabelle ein. Dann holt es mit HoleTableAnnotation.HoleTable und HoleTable.DatumOrigin den Bezugspunkt und gibt DatumOrigin.XLabel und DatumOrigin.YLabel aus. Eingefügt wird heute mit View.InsertHoleTable3.

Koordinaten: DatumOrigin.GetAxisPoints2 und DatumOrigin.SetAxisPoints arbeiten im Zeichenblatt (drawing space). Eine Einheit nennt die Hilfe nicht, es sind Meter auf dem Blatt. Die Lage des Symbols selbst liefert Annotation.GetPosition.

Veraltet: GetAxisPoints ist durch DatumOrigin.GetAxisPoints2 ersetzt. Das alte lieferte nur die beiden Pfeilspitzen, das neue auch die Anfänge der beiden Achslinien.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
TableLiefert die Bohrungstabelle, zu der der Bezugspunkt gehört.
XLabelLiest oder setzt die Beschriftung der X-Achse am Bezugspunkt.
YLabelLiest oder setzt die Beschriftung der Y-Achse am Bezugspunkt.

Methoden 6, davon 5 beschrieben, 1 veraltet

NameBeschreibung
GetAnnotationLiefert die allgemeine Beschriftung (Annotation) zum Bezugspunkt.
GetAxisPointsveraltet ersetzt durch DatumOrigin.GetAxisPoints2
GetAxisPoints2Liefert die vier Punkte, die die Form des Ursprungssymbols festlegen: Anfang und Pfeilspitze der X- und der Y-Achse.
GetNextLiefert den nächsten Bezugspunkt in der Zeichenansicht.
ReattachHängt den Bezugspunkt an das ausgewählte Element: eine Ecke, eine Kante oder einen Skizzenpunkt.
SetAxisPointsSetzt die Pfeilspitzen der X- und der Y-Achse und damit die Form des Ursprungssymbols.

Nicht aufgeführt sind 3 C++-Varianten (Namen mit I davor, zum Beispiel IGetAxisPoints). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

Englisches Original: IDatumOrigin in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.