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 VariantvEbene = swAnzeige.GetTextPlaneAtIndex(i)Parameter
IndexLongByVal- Nummer des Textstücks, beginnend bei
0, kleiner alsDisplayData.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 iBemerkungen
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.