Objekt · SldWorks
DatumTargetSym-Objekt
Ein Bezugsstellensymbol als Beschriftung: Bezugsangaben, Form und Größe des Zielbereichs, Anzeige, bewegliche Bezugsstelle und die Geometrie seiner Darstellung.
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
ModelDocExtension.InsertDatumTargetSymbol3: fügt an der ausgewählten Stelle ein neues Bezugsstellensymbol ein. Das Hilfebeispiel „Insert and Modify Datum Target Symbol“ wählt dazu in einem Teil eine Fläche aus.View.GetFirstDatumTargetSymund dannDatumTargetSym.GetNext: alle Bezugsstellensymbole einer ZeichenansichtView.GetDatumTargetSymsundView.GetDatumTargetSymCount: alle Bezugsstellensymbole einer Zeichenansicht als Array und ihre AnzahlAnnotation.GetSpecificAnnotation: aus einer Beschriftung, wennAnnotation.GetTypeswDatumTargetSym(swAnnotationType_e) liefert, etwa ausModelDocExtension.GetAnnotationsin einem TeilSelectionMgr.GetSelectedObject6: ein ausgewähltes Bezugsstellensymbol, wennSelectionMgr.GetSelectedObjectType3swSelDTMTARGS(swSelectType_e) liefert, so im Hilfebeispiel „Get Annotation Object“
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| GetAnnotation | Liefert die Beschriftung (Annotation) zum Bezugsstellensymbol, mit Lage, Layer, Bezugslinien und Textformat. |
| GetArcAtIndex | Liefert Linientyp, Anfangs-, End- und Mittelpunkt und Drehsinn eines Bogens in der Darstellung des Bezugsstellensymbols. |
| GetArcCount | Liefert die Zahl der Bögen in der Darstellung des Bezugsstellensymbols. |
| GetArrowHeadAtIndex | Liefert Spitze, Richtung, Maße und Art einer Pfeilspitze in der Darstellung des Bezugsstellensymbols. |
| GetArrowHeadCount | Liefert die Zahl der Pfeilspitzen in der Darstellung des Bezugsstellensymbols. |
| GetDatumReferenceLabel | Liefert eine Bezugsangabe des Bezugsstellensymbols, etwa „A1“. |
| GetDisplaySizeOutside | Liefert, ob die Größe des Zielbereichs außerhalb oder innerhalb des Bezugsstellensymbols steht. |
| GetDisplaySymbol | Liefert, ob das Bezugsstellensymbol selbst angezeigt wird. |
| GetDisplayTargetArea | Liefert, ob der Zielbereich des Bezugsstellensymbols angezeigt wird. |
| GetLineAtIndex | Liefert Linientyp, Anfangs- und Endpunkt einer Linie in der Darstellung des Bezugsstellensymbols. |
| GetLineCount | Liefert die Zahl der Linien in der Darstellung des Bezugsstellensymbols. |
| GetNext | Liefert das nächste Bezugsstellensymbol der Zeichenansicht, für eine Schleife über alle Bezugsstellensymbole. |
| GetTargetAreaSize | Liefert eine Größe des Zielbereichs als Text: den Durchmesser bei Punkt und Kreis, Breite oder Höhe beim Rechteck. |
| GetTargetShape | Liefert die Form des Zielbereichs: kein Bereich, Punkt, Kreis oder Rechteck. |
| GetTextAngleAtIndex | Liefert den Winkel eines Textstücks in der Darstellung des Bezugsstellensymbols. |
| GetTextAtIndex | Liefert ein Textstück aus der Darstellung des Bezugsstellensymbols. |
| GetTextCount | Liefert die Zahl der Textstücke in der Darstellung des Bezugsstellensymbols. |
| GetTextHeightAtIndex | Liefert die Schrifthöhe eines Textstücks in der Darstellung des Bezugsstellensymbols. |
| GetTextInvertAtIndex | Liefert, ob ein Textstück in der Darstellung des Bezugsstellensymbols an der X-Achse gespiegelt ist. |
| GetTextPositionAtIndex | Liefert die Lage eines Textstücks relativ zum Ursprung des Bezugsstellensymbols. |
| GetTextRefPositionAtIndex | Liefert, auf welchen Punkt eines Textstücks sich seine Lage bezieht, etwa oben links oder Mitte. |
| GetTriangleAtIndex | Liefert die Eckpunkte, die Füllung und den Linientyp eines Dreiecks in der Darstellung des Bezugsstellensymbols. |
| GetTriangleCount | Liefert die Zahl der Dreiecke in der Darstellung des Bezugsstellensymbols. |
| SetDatumReferenceLabel | Setzt eine Bezugsangabe des Bezugsstellensymbols, etwa „A1“. |
| SetDatumTargetHorizontal | Macht das Bezugsstellensymbol zu einer beweglichen Bezugsstelle im Stil horizontal. |
| SetDatumTargetNotMoveable | Macht aus einer beweglichen Bezugsstelle wieder ein normales Bezugsstellensymbol. |
| SetDatumTargetRotational | Macht das Bezugsstellensymbol zu einer beweglichen Bezugsstelle im Stil drehbar, auf Wunsch mit einer Kante als Richtung. |
| SetDisplay | Blendet das Bezugsstellensymbol und den Zielbereich ein oder aus und legt fest, ob die Größe innerhalb oder außerhalb des Symbols steht. |
| SetTargetArea | Setzt 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.