SolidWorksMakroprogrammierung

Objekt · SldWorks

DatumTargetSym-Objekt

Ein Bezugsstellensymbol als Beschriftung: Bezugsangaben, Form und Größe des Zielbereichs, Anzeige, bewegliche Bezugsstelle und die Geometrie seiner Darstellung.

Deklaration Dim x As SldWorks.DatumTargetSym · in der englischen .NET-Hilfe: IDatumTargetSym

Beschreibung

DatumTargetSym gibt Zugriff auf die Darstellung eines Bezugsstellensymbols (datum target symbol). Eine Bezugsstelle kennzeichnet die Stelle am Modell, auf die sich ein Bezug stützt, etwa einen Punkt, einen Kreis oder ein Rechteck. Die Beschriftung besteht aus zwei Teilen, die du einzeln ein- und ausblendest: dem Bezugsstellensymbol mit der Bezugslinie und dem Zielbereich am Modell. Im Symbol stehen die Bezugsangaben, etwa „A1“, und in der oberen Hälfte die Größe des Zielbereichs. Ein Bezugsstellensymbol kann auch eine bewegliche Bezugsstelle (movable datum target) sein, die Befehle dazu gibt es seit SOLIDWORKS 2018. Lage, Layer, Sichtbarkeit und Textformat stehen bei der zugehörigen Annotation, die du mit DatumTargetSym.GetAnnotation bekommst. Wo die Hilfe eine Version nennt, reicht sie von SOLIDWORKS 99 bis 2018.

Zugriff

Der Benutzer legt Bezugsstellen über Einfügen › Beschriftungen › Bezugsstelle an. In eine Zeichnung übernimmst du die Bezugsstellen des Modells mit DrawingDoc.InsertModelAnnotations3 und swInsertDatumTargets (swInsertAnnotation_e), so im Hilfebeispiel „Get Annotations Arrays“.

Beispiel

' Listet alle Bezugsstellensymbole der aktiven Zeichnung mit Bezugsangaben und Zielbereich auf.
' Vorbedingung: Eine Zeichnung mit Bezugsstellensymbolen 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 swStelle As SldWorks.DatumTargetSym
    Dim sBezuege As String
    Dim i As Long

    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 swStelle = swView.GetFirstDatumTargetSym
        Do While Not swStelle Is Nothing
            sBezuege = ""
            For i = 0 To 2                       ' vermutlich bis zu drei Bezugsangaben
                If swStelle.GetDatumReferenceLabel(i) <> "" Then sBezuege = sBezuege & " " & swStelle.GetDatumReferenceLabel(i)
            Next i
            Debug.Print swView.GetName2 & ": " & swStelle.GetAnnotation.GetName & ", Bezug" & sBezuege
            Select Case swStelle.GetTargetShape
                Case swDatumTargetAreaPoint
                    Debug.Print "  Punkt " & swStelle.GetTargetAreaSize(0)
                Case swDatumTargetAreaCircle
                    Debug.Print "  Kreis, Durchmesser " & swStelle.GetTargetAreaSize(0)
                Case swDatumTargetAreaRectangle
                    Debug.Print "  Rechteck " & swStelle.GetTargetAreaSize(0) & " x " & swStelle.GetTargetAreaSize(1)
                Case Else
                    Debug.Print "  Kein Zielbereich"
            End Select
            Debug.Print "  Symbol sichtbar: " & swStelle.GetDisplaySymbol & ", Zielbereich sichtbar: " & swStelle.GetDisplayTargetArea
            Set swStelle = swStelle.GetNext
        Loop
        Set swView = swView.GetNextView
    Loop
End Sub

Bemerkungen

Größe als Text: Die Größe des Zielbereichs liest und setzt du als Text, nicht als Zahl. Ein Punkt hat eine Größe, die leer sein darf, ein Kreis eine Größe (den Durchmesser) und ein Rechteck zwei (Breite und Höhe). SOLIDWORKS zeigt sie in der oberen Hälfte des Symbols, bei Punkt und Kreis mit Durchmesserzeichen davor, beim Rechteck durch ein „x“ getrennt. Die Formen stehen in swDatumTargetAreaShape_e. Achtung: Der Parameter AreaStyle von ModelDocExtension.InsertDatumTargetSymbol3 zählt nach Angabe der Hilfe anders (0 Punkt, 1 Kreis, 2 Rechteck).

Bezugsangaben: DatumTargetSym.GetDatumReferenceLabel und DatumTargetSym.SetDatumReferenceLabel zählen ab 0. Wie viele Bezugsangaben es gibt, sagt die Hilfe nicht. Vermutlich sind es drei, passend zu den Parametern Datum1 bis Datum3 beim Einfügen.

Bewegliche Bezugsstelle: Mit DatumTargetSym.SetDatumTargetHorizontal und DatumTargetSym.SetDatumTargetRotational machst du das Symbol zur beweglichen Bezugsstelle im Stil horizontal oder drehbar, mit DatumTargetSym.SetDatumTargetNotMoveable wieder zu einem normalen Symbol. Einen Befehl, der den Stil liest, hat DatumTargetSym nicht. Beim Einfügen legst du ihn mit einem Wert aus swMoveableDatumStyle_e fest.

Ändern über das Dokument: Alle Angaben eines ausgewählten Bezugsstellensymbols auf einmal änderst du mit ModelDoc2.EditDatumTargetSymbol.

Neu zeichnen: Nach DatumTargetSym.SetDatumReferenceLabel, DatumTargetSym.SetDisplay und DatumTargetSym.SetTargetArea zeichnest du neu, damit die Änderung zu sehen ist. Die Hilfe nennt dafür das veraltete ModelDoc2.GraphicsRedraw2. Der Nachfolger ist ModelView.GraphicsRedraw.

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

Verwandte Beschriftungen: Den Bezug selbst kennzeichnet der Bezugshinweis DatumTag. Bezugsstellen, die SOLIDWORKS aus einer STEP-242-Datei als PMI-Daten übernimmt, liest du mit Annotation.GetPMIData als PMIDatumTarget.

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

DatumTargetSym.GetTargetAreaSize liefert nach dem Einfügen mit ModelDocExtension.InsertDatumTargetSymbol3 eine leere Zeichenkette, auch wenn dort eine Größe angegeben war. Erst nach DatumTargetSym.SetTargetArea kommt der Wert zurück.

Eigenschaften und Methoden

Methoden 29, davon 29 beschrieben

NameBeschreibung
GetAnnotationLiefert die Beschriftung (Annotation) zum Bezugsstellensymbol, mit Lage, Layer, Bezugslinien und Textformat.
GetArcAtIndexLiefert Linientyp, Anfangs-, End- und Mittelpunkt und Drehsinn eines Bogens in der Darstellung des Bezugsstellensymbols.
GetArcCountLiefert die Zahl der Bögen in der Darstellung des Bezugsstellensymbols.
GetArrowHeadAtIndexLiefert Spitze, Richtung, Maße und Art einer Pfeilspitze in der Darstellung des Bezugsstellensymbols.
GetArrowHeadCountLiefert die Zahl der Pfeilspitzen in der Darstellung des Bezugsstellensymbols.
GetDatumReferenceLabelLiefert eine Bezugsangabe des Bezugsstellensymbols, etwa „A1“.
GetDisplaySizeOutsideLiefert, ob die Größe des Zielbereichs außerhalb oder innerhalb des Bezugsstellensymbols steht.
GetDisplaySymbolLiefert, ob das Bezugsstellensymbol selbst angezeigt wird.
GetDisplayTargetAreaLiefert, ob der Zielbereich des Bezugsstellensymbols angezeigt wird.
GetLineAtIndexLiefert Linientyp, Anfangs- und Endpunkt einer Linie in der Darstellung des Bezugsstellensymbols.
GetLineCountLiefert die Zahl der Linien in der Darstellung des Bezugsstellensymbols.
GetNextLiefert das nächste Bezugsstellensymbol der Zeichenansicht, für eine Schleife über alle Bezugsstellensymbole.
GetTargetAreaSizeLiefert eine Größe des Zielbereichs als Text: den Durchmesser bei Punkt und Kreis, Breite oder Höhe beim Rechteck.
GetTargetShapeLiefert die Form des Zielbereichs: kein Bereich, Punkt, Kreis oder Rechteck.
GetTextAngleAtIndexLiefert den Winkel eines Textstücks in der Darstellung des Bezugsstellensymbols.
GetTextAtIndexLiefert ein Textstück aus der Darstellung des Bezugsstellensymbols.
GetTextCountLiefert die Zahl der Textstücke in der Darstellung des Bezugsstellensymbols.
GetTextHeightAtIndexLiefert die Schrifthöhe eines Textstücks in der Darstellung des Bezugsstellensymbols.
GetTextInvertAtIndexLiefert, ob ein Textstück in der Darstellung des Bezugsstellensymbols an der X-Achse gespiegelt ist.
GetTextPositionAtIndexLiefert die Lage eines Textstücks relativ zum Ursprung des Bezugsstellensymbols.
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 Bezugsstellensymbols.
GetTriangleCountLiefert die Zahl der Dreiecke in der Darstellung des Bezugsstellensymbols.
SetDatumReferenceLabelSetzt eine Bezugsangabe des Bezugsstellensymbols, etwa „A1“.
SetDatumTargetHorizontalMacht das Bezugsstellensymbol zu einer beweglichen Bezugsstelle im Stil horizontal.
SetDatumTargetNotMoveableMacht aus einer beweglichen Bezugsstelle wieder ein normales Bezugsstellensymbol.
SetDatumTargetRotationalMacht das Bezugsstellensymbol zu einer beweglichen Bezugsstelle im Stil drehbar, auf Wunsch mit einer Kante als Richtung.
SetDisplayBlendet das Bezugsstellensymbol und den Zielbereich ein oder aus und legt fest, ob die Größe innerhalb oder außerhalb des Symbols steht.
SetTargetAreaSetzt Form und Größe des Zielbereichs: Punkt, Kreis oder Rechteck mit Durchmesser oder Breite und Höhe als Text.

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: IDatumTargetSym in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

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