SolidWorksMakroprogrammierung

Objekt · SldWorks

DatumTag-Objekt

Ein Bezugshinweis als Beschriftung: Bezugsdreieck mit Kennbuchstabe, Zusatztexten, Darstellung und Bezugslinie und die Geometrie seiner Darstellung.

Deklaration Dim x As SldWorks.DatumTag · in der englischen .NET-Hilfe: IDatumTag

Beschreibung

DatumTag gibt Zugriff auf die Darstellung eines Bezugshinweises (datum tag, an einigen Stellen der Hilfe datum feature symbol). Ein Bezugshinweis kennzeichnet ein Element als Bezug: Ein Kennbuchstabe wie „A“ steht in einem quadratischen oder runden Rahmen, eine Bezugslinie führt zum Modell und endet dort in einem gefüllten oder leeren Bezugsdreieck. Dazu kommen Zusatztexte vor, nach, über und unter dem Kennbuchstaben. Lage, Layer, Sichtbarkeit und Textformat stehen bei der zugehörigen Annotation, die du mit DatumTag.GetAnnotation bekommst. Wo die Hilfe eine Version nennt, reicht sie von SOLIDWORKS 99 bis 2011 SP03.

Zugriff

Beispiel

' Listet alle Bezugshinweise der aktiven Zeichnung mit Kennbuchstabe, Rahmen und Bezugsdreieck auf.
' Vorbedingung: Eine Zeichnung mit Bezugshinweisen ist geöffnet.
' Ergebnis:     Die Angaben stehen im Direktfenster (Strg+G).
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 swBezug As SldWorks.DatumTag
    Dim sRahmen As String

    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.GetFirstView            ' zuerst das Blatt selbst
    Do While Not swView Is Nothing
        Set swBezug = swView.GetFirstDatumTag
        Do While Not swBezug Is Nothing
            If swBezug.GetDisplayStyle = swDatumDisplayType_Roundgb Then
                sRahmen = "rund"
            Else
                sRahmen = "quadratisch"
            End If
            Debug.Print swView.GetName2 & ": " & swBezug.GetAnnotation.GetName & _
                ", Bezug " & swBezug.GetLabel & ", Rahmen " & sRahmen & _
                IIf(swBezug.GetUseDocDisplayStyle, " (wie im Dokument)", "") & _
                ", Dreieck " & IIf(swBezug.FilledTriangle, "gefüllt", "leer")
            Set swBezug = swBezug.GetNext
        Loop
        Set swView = swView.GetNextView
    Loop
End Sub

Bemerkungen

Kennbuchstabe und Zusatztexte: DatumTag.SetLabel nimmt höchstens zwei Zeichen. Präfix, Suffix und die Texte über und unter dem Symbol setzt DatumTag.SetText mit einem Wert aus swDatumTagTextParts_e. Einen Befehl, der diese Zusatztexte wieder liest, hat DatumTag nicht. Vermutlich findest du sie unter den Textstücken aus DatumTag.GetTextAtIndex. Das Hilfebeispiel „Set Text in Datum Tags and GTols“ setzt so die Texte des ersten Bezugshinweises einer Ansicht und liest seinen Kennbuchstaben.

Darstellung: Ein Bezugshinweis ist quadratisch oder rund nach der chinesischen Norm GB (swDatumDisplayType_e). DatumTag.Shoulder gilt nur für quadratische, DatumTag.LeaderOrientation nur für runde Bezugshinweise. Du kannst beide jederzeit lesen und setzen, siehst aber bei der anderen Darstellung keine Wirkung.

Vorgaben im Dokument: Die Vorgaben für neue Bezugshinweise stehen in den Dokumenteigenschaften unter Beschriftungen › Bezugshinweise (Annotations › Datums): swDetailingDatumDisplayType und swDetailingDatumGbLeaderStyle aus swUserPreferenceIntegerValue_e, swDetailingDatumsAnchorFilled und swDetailingDatumsAnchorShoulder aus swUserPreferenceToggle_e und der nächste Kennbuchstabe swDetailingNextDatumFeatureLabel aus swUserPreferenceStringValue_e.

Neu zeichnen: Nach DatumTag.SetText musst du mit ModelView.GraphicsRedraw neu zeichnen, damit der neue Text zu sehen ist.

Einheiten: DatumTag.GetTextAngleAtIndex ist in Bogenmaß und DatumTag.GetTextHeightAtIndex in Metern. Bei den übrigen Koordinaten nennt die Hilfe keine Einheit, es sind Meter auf dem Blatt.

Verwandte Beschriftungen: Die Stelle am Modell, auf die sich ein Bezug stützt, kennzeichnet das Bezugsstellensymbol DatumTargetSym. In einer Form- und Lagetoleranz (Gtol) stehen die Kennbuchstaben in den Bezugsfeldern des Rahmens. Bezugshinweise, die SOLIDWORKS aus einer STEP-242-Datei als PMI-Daten übernimmt, liest du wie im Hilfebeispiel „Get PMI Data“ mit Annotation.GetPMIData als PMIDatumFeature.

Variablenname: VBA unterscheidet Groß- und Kleinschreibung nicht. Eine Variable swDatumTag hätte deshalb denselben Namen wie die Konstante swDatumTag aus swAnnotationType_e. Die Beispiele nennen die Variable deshalb swBezug.

Eigenschaften und Methoden

Eigenschaften 4, davon 4 beschrieben

NameBeschreibung
FilledTriangleLiest oder setzt, ob das Bezugsdreieck am Ende der Bezugslinie des Bezugshinweises gefüllt oder leer ist.
ForcedShoulderLiefert, ob die Bezugslinie des Bezugshinweises einen erzwungenen Knick hat, den du nicht entfernen kannst.
LeaderOrientationLiest oder setzt, in welche Richtung die Bezugslinie eines runden Bezugshinweises abgeht: waagerecht, senkrecht oder rechtwinklig.
ShoulderLiest oder setzt, ob die Bezugslinie eines quadratischen Bezugshinweises einen Knick hat.

Methoden 23, davon 23 beschrieben

NameBeschreibung
GetAnnotationLiefert die Beschriftung (Annotation) zum Bezugshinweis, mit Lage, Layer, Bezugslinien und Textformat.
GetArcAtIndexLiefert Linientyp, Anfangs-, End- und Mittelpunkt und Drehsinn eines Bogens in der Darstellung des Bezugshinweises.
GetArcCountLiefert die Zahl der Bögen in der Darstellung des Bezugshinweises.
GetArrowHeadAtIndexLiefert Spitze, Richtung, Maße und Art einer Pfeilspitze in der Darstellung des Bezugshinweises.
GetArrowHeadCountLiefert die Zahl der Pfeilspitzen in der Darstellung des Bezugshinweises.
GetDisplayStyleLiefert, ob der Bezugshinweis quadratisch oder rund nach der Norm GB dargestellt wird.
GetLabelLiefert den Kennbuchstaben des Bezugshinweises, etwa „A“.
GetLineAtIndexLiefert Linientyp, Anfangs- und Endpunkt einer Linie in der Darstellung des Bezugshinweises.
GetLineCountLiefert die Zahl der Linien in der Darstellung des Bezugshinweises.
GetNextLiefert den nächsten Bezugshinweis der Zeichenansicht, für eine Schleife über alle Bezugshinweise.
GetTextAngleAtIndexLiefert den Winkel eines Textstücks in der Darstellung des Bezugshinweises.
GetTextAtIndexLiefert ein Textstück aus der Darstellung des Bezugshinweises.
GetTextCountLiefert die Zahl der Textstücke in der Darstellung des Bezugshinweises.
GetTextHeightAtIndexLiefert die Schrifthöhe eines Textstücks in der Darstellung des Bezugshinweises.
GetTextInvertAtIndexLiefert, ob ein Textstück in der Darstellung des Bezugshinweises an der X-Achse gespiegelt ist.
GetTextPositionAtIndexLiefert die Lage eines Textstücks relativ zum Ursprung des Bezugshinweises.
GetTextRefPositionAtIndexLiefert, auf welchen Punkt eines Textstücks sich seine Lage bezieht, etwa oben links oder Mitte.
GetTriangleAtIndexLiefert die Eckpunkte, die Füllung und den Linientyp eines Dreiecks in der Darstellung des Bezugshinweises.
GetTriangleCountLiefert die Zahl der Dreiecke in der Darstellung des Bezugshinweises.
GetUseDocDisplayStyleLiefert, ob der Bezugshinweis für seine Darstellung die Einstellung des Dokuments verwendet.
SetDisplayStyleLegt fest, ob der Bezugshinweis der Einstellung des Dokuments folgt oder quadratisch oder rund dargestellt wird.
SetLabelSetzt den Kennbuchstaben des Bezugshinweises, höchstens zwei Zeichen.
SetTextSetzt einen Zusatztext des Bezugshinweises: Präfix, Suffix, Text darüber oder Text darunter.

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

Siehe auch

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

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