Objekt · SldWorks
DatumTag-Objekt
Ein Bezugshinweis als Beschriftung: Bezugsdreieck mit Kennbuchstabe, Zusatztexten, Darstellung und Bezugslinie und die Geometrie seiner Darstellung.
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
ModelDoc2.InsertDatumTag2: fügt an der ausgewählten Stelle einen neuen Bezugshinweis ein. Das Hilfebeispiel „Get Annotations Arrays“ wählt dazu in einem Teil eine Kante aus.View.GetFirstDatumTagund dannDatumTag.GetNext: alle Bezugshinweise einer ZeichenansichtView.GetDatumTagsundView.GetDatumTagCount: alle Bezugshinweise einer Zeichenansicht als Array und ihre AnzahlAnnotation.GetSpecificAnnotation: aus einer Beschriftung, wennAnnotation.GetTypeswDatumTag(swAnnotationType_e) liefert, etwa ausModelDocExtension.GetAnnotationsin einem TeilSelectionMgr.GetSelectedObject6: ein ausgewählter Bezugshinweis, wennSelectionMgr.GetSelectedObjectType3swSelDATUMTAGS(swSelectType_e) liefert, so im Hilfebeispiel „Get Annotation Object“
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| FilledTriangle | Liest oder setzt, ob das Bezugsdreieck am Ende der Bezugslinie des Bezugshinweises gefüllt oder leer ist. |
| ForcedShoulder | Liefert, ob die Bezugslinie des Bezugshinweises einen erzwungenen Knick hat, den du nicht entfernen kannst. |
| LeaderOrientation | Liest oder setzt, in welche Richtung die Bezugslinie eines runden Bezugshinweises abgeht: waagerecht, senkrecht oder rechtwinklig. |
| Shoulder | Liest oder setzt, ob die Bezugslinie eines quadratischen Bezugshinweises einen Knick hat. |
Methoden 23, davon 23 beschrieben
| Name | Beschreibung |
|---|---|
| GetAnnotation | Liefert die Beschriftung (Annotation) zum Bezugshinweis, mit Lage, Layer, Bezugslinien und Textformat. |
| GetArcAtIndex | Liefert Linientyp, Anfangs-, End- und Mittelpunkt und Drehsinn eines Bogens in der Darstellung des Bezugshinweises. |
| GetArcCount | Liefert die Zahl der Bögen in der Darstellung des Bezugshinweises. |
| GetArrowHeadAtIndex | Liefert Spitze, Richtung, Maße und Art einer Pfeilspitze in der Darstellung des Bezugshinweises. |
| GetArrowHeadCount | Liefert die Zahl der Pfeilspitzen in der Darstellung des Bezugshinweises. |
| GetDisplayStyle | Liefert, ob der Bezugshinweis quadratisch oder rund nach der Norm GB dargestellt wird. |
| GetLabel | Liefert den Kennbuchstaben des Bezugshinweises, etwa „A“. |
| GetLineAtIndex | Liefert Linientyp, Anfangs- und Endpunkt einer Linie in der Darstellung des Bezugshinweises. |
| GetLineCount | Liefert die Zahl der Linien in der Darstellung des Bezugshinweises. |
| GetNext | Liefert den nächsten Bezugshinweis der Zeichenansicht, für eine Schleife über alle Bezugshinweise. |
| GetTextAngleAtIndex | Liefert den Winkel eines Textstücks in der Darstellung des Bezugshinweises. |
| GetTextAtIndex | Liefert ein Textstück aus der Darstellung des Bezugshinweises. |
| GetTextCount | Liefert die Zahl der Textstücke in der Darstellung des Bezugshinweises. |
| GetTextHeightAtIndex | Liefert die Schrifthöhe eines Textstücks in der Darstellung des Bezugshinweises. |
| GetTextInvertAtIndex | Liefert, ob ein Textstück in der Darstellung des Bezugshinweises an der X-Achse gespiegelt ist. |
| GetTextPositionAtIndex | Liefert die Lage eines Textstücks relativ zum Ursprung des Bezugshinweises. |
| 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 Bezugshinweises. |
| GetTriangleCount | Liefert die Zahl der Dreiecke in der Darstellung des Bezugshinweises. |
| GetUseDocDisplayStyle | Liefert, ob der Bezugshinweis für seine Darstellung die Einstellung des Dokuments verwendet. |
| SetDisplayStyle | Legt fest, ob der Bezugshinweis der Einstellung des Dokuments folgt oder quadratisch oder rund dargestellt wird. |
| SetLabel | Setzt den Kennbuchstaben des Bezugshinweises, höchstens zwei Zeichen. |
| SetText | Setzt 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.