SolidWorksMakroprogrammierung

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 Variant
vBoegen = 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 If

Bemerkungen

Nach Angabe der Hilfe stehen je Bogen diese Werte, für den Bogen i vermutlich ab der Stelle 11 * i:

  • 0 bis 2: X, Y, Z des Mittelpunkts
  • 3 bis 5: X, Y, Z des Anfangspunkts
  • 6 bis 8: X, Y, Z des Endpunkts
  • 9: ob der Bogen gefüllt ist
  • 10: 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.