SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.DisplayData · in der englischen .NET-Hilfe: IDisplayData

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

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 Sub

Bemerkungen

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

NameBeschreibung
GetArcAtIndexveraltet ersetzt durch DisplayData.GetArcAtIndex2
GetArcAtIndex2Liefert Farbe, Linientyp, Anfangs-, End- und Mittelpunkt, Normale und Drehsinn eines Bogens in den Darstellungsdaten.
GetArcCountLiefert die Zahl der Bögen in den Darstellungsdaten.
GetArrowHeadAtIndexveraltet ersetzt durch DisplayData.GetArrowHeadAtIndex2
GetArrowHeadAtIndex2Liefert Spitze, Richtung, Maße, Art und Normale einer Pfeilspitze in den Darstellungsdaten.
GetArrowHeadCountLiefert die Zahl der Pfeilspitzen in den Darstellungsdaten.
GetEllipseAtIndexveraltet ersetzt durch DisplayData.GetEllipseAtIndex2
GetEllipseAtIndex2Liefert Farbe, Linientyp, Anfangs-, End- und Mittelpunkt und je einen Punkt auf der großen und kleinen Achse einer Ellipse in den Darstellungsdaten.
GetEllipseCountLiefert die Zahl der Ellipsen in den Darstellungsdaten.
GetLineAtIndexveraltet ersetzt durch DisplayData.GetLineAtIndex3
GetLineAtIndex2veraltet ersetzt durch DisplayData.GetLineAtIndex3
GetLineAtIndex3Liefert Farbe, Linientyp, Linienart, Linienstärke, Anfangs- und Endpunkt einer Linie in den Darstellungsdaten.
GetLineCountLiefert die Zahl der Linien in den Darstellungsdaten.
GetParabolaAtIndexLiefert Farbe, Linientyp, Linienstil, Linienstärke, Anfangs-, End-, Brenn- und Scheitelpunkt einer Parabel in den Darstellungsdaten.
GetParabolaCountLiefert die Zahl der Parabeln in den Darstellungsdaten.
GetPointAtIndexLiefert Farbe, Linientyp, Punktsymbol, Füllung und Lage eines Punkts in den Darstellungsdaten.
GetPointCountLiefert die Zahl der Punkte in den Darstellungsdaten.
GetPolygonAtIndexLiefert Farbe, Linientyp und Eckpunkte eines Vielecks in den Darstellungsdaten.
GetPolygonCountLiefert die Zahl der Vielecke in den Darstellungsdaten.
GetPolygonSizeAtIndexLiefert, wie viele Zahlen das Array von GetPolygonAtIndex für ein Vieleck hat.
GetPolylineAtIndexveraltet ersetzt durch DisplayData.GetPolylineAtIndex2
GetPolylineAtIndex2Liefert Art, Farbe, Linientyp und Punkte einer Polylinie in den Darstellungsdaten.
GetPolyLineCountLiefert die Zahl der Polylinien in den Darstellungsdaten.
GetPolylineSizeAtIndexveraltet ersetzt durch DisplayData.GetPolylineSizeAtIndex2
GetPolylineSizeAtIndex2Liefert, wie viele Zahlen das Array von GetPolylineAtIndex2 für eine Polylinie hat.
GetTextAngleAtIndexLiefert den Winkel eines Textstücks in den Darstellungsdaten.
GetTextAtIndexLiefert ein Textstück aus den Darstellungsdaten.
GetTextCountLiefert die Zahl der Textstücke in den Darstellungsdaten.
GetTextFontAtIndexLiefert die Schriftart eines Textstücks in den Darstellungsdaten.
GetTextHeightAtIndexLiefert die Schrifthöhe eines Textstücks in den Darstellungsdaten.
GetTextInBoxHeightAtIndexLiefert die Höhe des festen Textbereichs eines Texts in einer Tabellenzelle.
GetTextInBoxStyleAtIndexLiefert, wie ein Text einer Tabellenzelle in seinem festen Textbereich steht: ohne Bereich, umgebrochen oder eingepasst.
GetTextInBoxWidthAtIndexLiefert die Breite des festen Textbereichs eines Texts in einer Tabellenzelle.
GetTextInvertAtIndexLiefert, ob ein Textstück in den Darstellungsdaten an der X-Achse gespiegelt ist.
GetTextLineSpacingAtIndexLiefert den Zeilenabstand eines Textstücks in den Darstellungsdaten.
GetTextPlaneAtIndexLiefert die Drehmatrix der Ebene eines Textstücks relativ zur XY-Ebene des Modells.
GetTextPositionAtIndexLiefert die Lage eines Textstücks relativ zum Ursprung der Darstellungsdaten.
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 den Darstellungsdaten.
GetTriangleCountLiefert 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.