Methode · Environment
GetSymArcs2-Methode (Environment)
Liefert Mittel-, Anfangs- und Endpunkt aller Bögen eines Symbols der Symbolbibliothek und ob sie gefüllt sind und eine Sehne haben.
Syntax
Function GetSymArcs2( _
ByVal SymId As String _
) As VariantvBoegen = swEnv.GetSymArcs2("<GTOL-SPROF>")Parameter
SymIdStringByVal- Name des Symbols in der Form
<Bibliothek-Symbol>, etwa<MOD-DEG>, wie in der Datei gtol.sym.
Rückgabewert
Array mit elf Werten je Bogen: Mittelpunkt, Anfangspunkt und Endpunkt mit je X, Y, Z, dazu ob der Bogen gefüllt ist und ob die Sehne gezeichnet wird. Die Aufteilung steht in den Bemerkungen.
Beispiel
' swEnv ist die Umgebung (Environment), etwa aus SldWorks.GetEnvironment.
Dim vZahl As Variant, vBoegen As Variant
Dim i As Long
vZahl = swEnv.GetSymEdgeCounts("<GTOL-SPROF>")
If vZahl(1) > 0 Then
vBoegen = swEnv.GetSymArcs2("<GTOL-SPROF>")
For i = 0 To vZahl(1) - 1
Debug.Print "Bogen " & i & ": Mitte " & vBoegen(11 * i) & " / " & vBoegen(11 * i + 1) & _
", gefüllt " & vBoegen(11 * i + 9) & ", Sehne " & vBoegen(11 * i + 10)
Next i
End IfBemerkungen
Nach Angabe der Hilfe stehen je Bogen diese Werte, für den Bogen i vermutlich ab der Stelle 11 * i:
0bis2: X, Y, Z des Mittelpunkts3bis5: X, Y, Z des Anfangspunkts6bis8: X, Y, Z des Endpunkts9: ob der Bogen gefüllt ist10: ob die Sehne zwischen Anfangs- und Endpunkt gezeichnet wird
Die Zahl der Bögen liefert Environment.GetSymEdgeCounts an Stelle 1. Die Hilfe beschreibt die elf Werte als „array for each arc“. Dass sie wie bei Environment.GetSymLines in einem Array hintereinander stehen, sagt sie nur indirekt: Das Hilfebeispiel „Analyze Text and Geometry in GTol Symbol“ gibt alle Werte in einer Schleife bis UBound aus und nennt für gefüllt und Sehne 1 für ja und 0 für nein. Den Datentyp der Werte nennt die Hilfe nicht, vermutlich Double wie bei den übrigen Befehlen.
Die Zahlen beziehen sich auf eine Texthöhe von 1. Hat das Symbol die Texthöhe 0,15, multiplizierst du sie mit 0,15.
GetSymArcs2 ersetzt das veraltete Environment.GetSymArcs, das je Bogen nur die neun Koordinaten lieferte.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2015 SP01
Englisches Original: IEnvironment::GetSymArcs2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.