SolidWorksMakroprogrammierung

Methode · DisplayData

GetTextPlaneAtIndex-Methode (DisplayData)

Liefert die Drehmatrix der Ebene eines Textstücks relativ zur XY-Ebene des Modells.

Syntax

Function GetTextPlaneAtIndex( _
   ByVal Index As Long _
) As Variant
vEbene = swAnzeige.GetTextPlaneAtIndex(i)

Parameter

IndexLongByVal
Nummer des Textstücks, beginnend bei 0, kleiner als DisplayData.GetTextCount.

Rückgabewert

Array mit 9 Zahlen (Double): die Drehmatrix der Textebene. Nach Angabe der Hilfe ist die Reihenfolge anders als bei anderen Ebenen-Befehlen: die X-Achse steht in 0, 3, 6, die Y-Achse in 1, 4, 7 und die Z-Achse in 2, 5, 8.

Beispiel

' swAnzeige sind die Darstellungsdaten (DisplayData) einer Beschriftung, etwa aus Annotation.GetDisplayData.
Dim vEbene As Variant
Dim i As Long
For i = 0 To swAnzeige.GetTextCount - 1
    vEbene = swAnzeige.GetTextPlaneAtIndex(i)
    If Not IsEmpty(vEbene) Then
        Debug.Print swAnzeige.GetTextAtIndex(i)
        Debug.Print "  X-Achse: " & vEbene(0) & ", " & vEbene(3) & ", " & vEbene(6)
        Debug.Print "  Y-Achse: " & vEbene(1) & ", " & vEbene(4) & ", " & vEbene(7)
        Debug.Print "  Z-Achse: " & vEbene(2) & ", " & vEbene(5) & ", " & vEbene(8)
    End If
Next i

Bemerkungen

Das Hilfebeispiel liest in einem Teil mit drei Bezugshinweisen in verschiedenen Ebenen die Beschriftungen mit ModelDocExtension.GetAnnotations und je Beschriftung die Darstellungsdaten. Es setzt sehr kleine Werte auf 0, dreht die X-Achse mit dem Winkel aus DisplayData.GetTextAngleAtIndex in der XY-Ebene der Textebene und bildet die neue Y-Achse als Kreuzprodukt von Z- und X-Achse. Seine Schleife läuft bis GetTextCount statt bis GetTextCount − 1 und prüft das Ergebnis mit IsEmpty.

Die Ebene der ganzen Beschriftung liefert Annotation.GetPlane.

Bei einem Hinweis in einer Zeichnung liefert GetTextPlaneAtIndex Empty. Prüf das Ergebnis deshalb mit IsEmpty, wie im Beispiel.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2019 SP01

Englisches Original: IDisplayData::GetTextPlaneAtIndex in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

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