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.
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
HoleTable.DatumOrigin: der Bezugspunkt einer BohrungstabelleView.GetFirstDatumOriginund dannDatumOrigin.GetNext: alle Bezugspunkte einer Zeichenansicht nacheinanderView.GetDatumOrigins: alle Bezugspunkte einer Zeichenansicht als Array, die Zahl liefertView.GetDatumOriginCountAnnotation.GetSpecificAnnotation: aus einer Beschriftung vom TypswDatumOrigin(swAnnotationType_e)
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Table | Liefert die Bohrungstabelle, zu der der Bezugspunkt gehört. |
| XLabel | Liest oder setzt die Beschriftung der X-Achse am Bezugspunkt. |
| YLabel | Liest oder setzt die Beschriftung der Y-Achse am Bezugspunkt. |
Methoden 6, davon 5 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| GetAnnotation | Liefert die allgemeine Beschriftung (Annotation) zum Bezugspunkt. |
| GetAxisPoints | veraltet ersetzt durch DatumOrigin.GetAxisPoints2 |
| GetAxisPoints2 | Liefert die vier Punkte, die die Form des Ursprungssymbols festlegen: Anfang und Pfeilspitze der X- und der Y-Achse. |
| GetNext | Liefert den nächsten Bezugspunkt in der Zeichenansicht. |
| Reattach | Hängt den Bezugspunkt an das ausgewählte Element: eine Ecke, eine Kante oder einen Skizzenpunkt. |
| SetAxisPoints | Setzt 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.