Objekt · SldWorks
DisplayData-Objekt
Die Darstellungsdaten einer Beschriftung, Bemaßung, Tabelle oder Zeichenansicht: die gezeichnete Geometrie aus Linien, Bögen, Ellipsen, Parabeln, Polylinien, Vielecken, Dreiecken, Punkten, Pfeilspitzen und Texten.
Beschreibung
DisplayData gibt Zugriff auf die Darstellungsinformationen bestimmter Elemente, etwa der Referenzebenen und Referenzachsen, die in einer Zeichenansicht angezeigt werden. DisplayData beschreibt, was SOLIDWORKS zeichnet, als einfache Geometrie: Linien, Bögen, Texte, Pfeilspitzen usw. Alle Befehle liefern nur Angaben. Für jede Art gibt es einen Befehl für die Anzahl und einen, der ein Element über seine Nummer liefert, meist beginnend bei 0. Die Geometrie kommt als Array aus Double-Werten. Wo die Hilfe eine Version nennt, reicht sie von SOLIDWORKS 2000 bis 2019 SP01.
Zugriff
Annotation.GetDisplayData: die Darstellungsdaten einer Beschriftung, so in den Hilfebeispielen „Get Centerline Annotation Information“ für eine Mittellinie und „Get Weld Bead Symbol Data“ für ein SchweißnahtsymbolDisplayDimension.GetDisplayData: die Darstellungsdaten einer BemaßungBomTable.GetDisplayData: die Darstellungsdaten einer StücklisteCThread.GetDisplayData: die Darstellungsdaten eines GewindesMultiJogLeader.GetDisplayData: die Darstellungsdaten einer Bezugslinie mit mehreren KnickenView.GetDisplayData4: die Darstellungsdaten einer Zeichenansicht für die Modellelemente, die in der Ansicht sichtbar sindView.GetSMBoundaryBoxDisplayData2: die Darstellungsdaten der Begrenzungsrahmen-Skizze in der Ansicht einer Blech-Abwicklung
Beispiel
' Listet für jede Beschriftung der aktiven Zeichnung auf, aus wie vielen Linien,
' Bögen, Polylinien, Vielecken und Textstücken sie gezeichnet wird, dazu die Texte.
' Vorbedingung: Eine Zeichnung mit Beschriftungen 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 swAnn As SldWorks.Annotation
Dim swAnzeige As SldWorks.DisplayData
Dim vListe As Variant
Dim i As Long, j 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
vListe = swView.GetAnnotations
If Not IsEmpty(vListe) Then
For i = 0 To UBound(vListe)
Set swAnn = vListe(i)
Set swAnzeige = swAnn.GetDisplayData
If Not swAnzeige Is Nothing Then
Debug.Print swView.GetName2 & ": " & swAnn.GetName & " – " & _
swAnzeige.GetLineCount & " Linien, " & swAnzeige.GetArcCount & " Bögen, " & _
swAnzeige.GetPolyLineCount & " Polylinien, " & swAnzeige.GetPolygonCount & " Vielecke, " & _
swAnzeige.GetTextCount & " Textstücke"
For j = 0 To swAnzeige.GetTextCount - 1
Debug.Print " Text " & j & ": " & swAnzeige.GetTextAtIndex(j)
Next j
End If
Next i
End If
Set swView = swView.GetNextView
Loop
End SubBemerkungen
Nur zum Anzeigen: Nach View.GetDisplayData3 sind die Darstellungsdaten nur zum Anzeigen gedacht. Du kannst damit die Geometrie als einfache Linien, Bögen und Texte nachzeichnen, bekommst aber keine Zuordnungen (etwa zu Modell, Kanten oder Flächen) und keine genaueren Angaben zur Geometrie.
Aufbau der Arrays: Die neueren Befehle für Linien, Bögen, Ellipsen und Parabeln beginnen mit vier gleichen Stellen: 0 die Farbe als COLORREF-Wert (0 oder -1 für die Standardfarbe), 1 der Linientyp aus swLineTypes_e, dann Linienart und Linienstärke oder zwei unbenutzte Stellen. Ab Stelle 4 folgen die Punkte mit je drei Zahlen X, Y, Z. Bei Polylinien und Vielecken steht vor den Punkten ihre Zahl. Die Gesamtlänge liefern dort DisplayData.GetPolylineSizeAtIndex2 und DisplayData.GetPolygonSizeAtIndex. Bei Punkten, Parabeln, Polylinien und Ellipsen passt die Beschreibung der Hilfe nicht ganz zu den aufgezählten Werten, Einzelheiten stehen auf den Befehlsseiten. Prüf die Länge der Arrays bei Bedarf mit UBound.
Einheiten und Koordinaten: Die Schrifthöhe ist in Meter und der Textwinkel im Bogenmaß. Für die Koordinaten nennt die Hilfe weder Einheit noch Koordinatensystem, vermutlich Meter. Bei Note sind es Blattkoordinaten in Zeichnungen und Modellkoordinaten in Teilen und Baugruppen. Ob das für DisplayData genauso gilt, sagt die Hilfe nicht.
Gleiche Befehle bei anderen Objekten: Gtol, Note und MultiJogLeader haben eigene Befehle für ihre gezeichnete Geometrie, etwa Gtol.GetLineAtIndex und Note.GetArcAtIndex. Deren Arrays entsprechen den veralteten Vorgängern hier, ohne Farbe und unbenutzte Stellen. Bei DisplayData beginnen die Punkte einer Linie deshalb an Stelle 4, nicht an Stelle 1.
Veraltete Befehle: Sieben Befehle sind veraltet: GetArcAtIndex, GetArrowHeadAtIndex, GetEllipseAtIndex, GetLineAtIndex, GetLineAtIndex2, GetPolylineAtIndex und GetPolylineSizeAtIndex. Ihre Nachfolger sind die Befehle mit der nächsthöheren Nummer, etwa DisplayData.GetLineAtIndex3 und DisplayData.GetArcAtIndex2.
Eigenschaften und Methoden
Methoden 40, davon 33 beschrieben, 7 veraltet
| Name | Beschreibung |
|---|---|
| GetArcAtIndex | veraltet ersetzt durch DisplayData.GetArcAtIndex2 |
| GetArcAtIndex2 | Liefert Farbe, Linientyp, Anfangs-, End- und Mittelpunkt, Normale und Drehsinn eines Bogens in den Darstellungsdaten. |
| GetArcCount | Liefert die Zahl der Bögen in den Darstellungsdaten. |
| GetArrowHeadAtIndex | veraltet ersetzt durch DisplayData.GetArrowHeadAtIndex2 |
| GetArrowHeadAtIndex2 | Liefert Spitze, Richtung, Maße, Art und Normale einer Pfeilspitze in den Darstellungsdaten. |
| GetArrowHeadCount | Liefert die Zahl der Pfeilspitzen in den Darstellungsdaten. |
| GetEllipseAtIndex | veraltet ersetzt durch DisplayData.GetEllipseAtIndex2 |
| GetEllipseAtIndex2 | Liefert Farbe, Linientyp, Anfangs-, End- und Mittelpunkt und je einen Punkt auf der großen und kleinen Achse einer Ellipse in den Darstellungsdaten. |
| GetEllipseCount | Liefert die Zahl der Ellipsen in den Darstellungsdaten. |
| GetLineAtIndex | veraltet ersetzt durch DisplayData.GetLineAtIndex3 |
| GetLineAtIndex2 | veraltet ersetzt durch DisplayData.GetLineAtIndex3 |
| GetLineAtIndex3 | Liefert Farbe, Linientyp, Linienart, Linienstärke, Anfangs- und Endpunkt einer Linie in den Darstellungsdaten. |
| GetLineCount | Liefert die Zahl der Linien in den Darstellungsdaten. |
| GetParabolaAtIndex | Liefert Farbe, Linientyp, Linienstil, Linienstärke, Anfangs-, End-, Brenn- und Scheitelpunkt einer Parabel in den Darstellungsdaten. |
| GetParabolaCount | Liefert die Zahl der Parabeln in den Darstellungsdaten. |
| GetPointAtIndex | Liefert Farbe, Linientyp, Punktsymbol, Füllung und Lage eines Punkts in den Darstellungsdaten. |
| GetPointCount | Liefert die Zahl der Punkte in den Darstellungsdaten. |
| GetPolygonAtIndex | Liefert Farbe, Linientyp und Eckpunkte eines Vielecks in den Darstellungsdaten. |
| GetPolygonCount | Liefert die Zahl der Vielecke in den Darstellungsdaten. |
| GetPolygonSizeAtIndex | Liefert, wie viele Zahlen das Array von GetPolygonAtIndex für ein Vieleck hat. |
| GetPolylineAtIndex | veraltet ersetzt durch DisplayData.GetPolylineAtIndex2 |
| GetPolylineAtIndex2 | Liefert Art, Farbe, Linientyp und Punkte einer Polylinie in den Darstellungsdaten. |
| GetPolyLineCount | Liefert die Zahl der Polylinien in den Darstellungsdaten. |
| GetPolylineSizeAtIndex | veraltet ersetzt durch DisplayData.GetPolylineSizeAtIndex2 |
| GetPolylineSizeAtIndex2 | Liefert, wie viele Zahlen das Array von GetPolylineAtIndex2 für eine Polylinie hat. |
| GetTextAngleAtIndex | Liefert den Winkel eines Textstücks in den Darstellungsdaten. |
| GetTextAtIndex | Liefert ein Textstück aus den Darstellungsdaten. |
| GetTextCount | Liefert die Zahl der Textstücke in den Darstellungsdaten. |
| GetTextFontAtIndex | Liefert die Schriftart eines Textstücks in den Darstellungsdaten. |
| GetTextHeightAtIndex | Liefert die Schrifthöhe eines Textstücks in den Darstellungsdaten. |
| GetTextInBoxHeightAtIndex | Liefert die Höhe des festen Textbereichs eines Texts in einer Tabellenzelle. |
| GetTextInBoxStyleAtIndex | Liefert, wie ein Text einer Tabellenzelle in seinem festen Textbereich steht: ohne Bereich, umgebrochen oder eingepasst. |
| GetTextInBoxWidthAtIndex | Liefert die Breite des festen Textbereichs eines Texts in einer Tabellenzelle. |
| GetTextInvertAtIndex | Liefert, ob ein Textstück in den Darstellungsdaten an der X-Achse gespiegelt ist. |
| GetTextLineSpacingAtIndex | Liefert den Zeilenabstand eines Textstücks in den Darstellungsdaten. |
| GetTextPlaneAtIndex | Liefert die Drehmatrix der Ebene eines Textstücks relativ zur XY-Ebene des Modells. |
| GetTextPositionAtIndex | Liefert die Lage eines Textstücks relativ zum Ursprung der Darstellungsdaten. |
| 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 den Darstellungsdaten. |
| GetTriangleCount | Liefert die Zahl der Dreiecke in den Darstellungsdaten. |
Nicht aufgeführt sind 15 C++-Varianten (Namen mit I davor, zum Beispiel IGetArcAtIndex). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IDisplayData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.