SolidWorksMakroprogrammierung

Methode · Gtol

GetSymLines-Methode (Gtol)

Liefert Anfangs- und Endpunkt aller Linien eines Toleranzsymbols, etwa des Symbols für Ebenheit.

Syntax

Function GetSymLines( _
   ByVal SymIdx As Integer _
) As Variant
vLinien = swGtol.GetSymLines(swGcsFLAT)

Parameter

SymIdxIntegerByVal
Welches Symbol. Die Hilfe sagt hier nur „Indexed position of the symbol“, vermutlich ist wie bei Gtol.GetSymName ein Wert aus swGtolGeomCharSymbol_e gemeint.

Rückgabewert

Array mit Double-Werten, je Linie sechs: Für die Linie i stehen an 6 * i bis 6 * i + 2 X, Y, Z des ersten Punkts und an 6 * i + 3 bis 6 * i + 5 des zweiten.

Beispiel

' swGtol ist eine Form- und Lagetoleranz (Gtol), etwa aus View.GetFirstGTOL.
Dim vZahl As Variant, vLinien As Variant
Dim i As Long
vZahl = swGtol.GetSymEdgeCounts(swGcsFLAT)
If vZahl(0) > 0 Then
    vLinien = swGtol.GetSymLines(swGcsFLAT)
    For i = 0 To vZahl(0) - 1
        Debug.Print "Linie " & i & ": " & vLinien(6 * i) & " / " & vLinien(6 * i + 1) & " -> " & _
            vLinien(6 * i + 3) & " / " & vLinien(6 * i + 4)
    Next i
End If

Bemerkungen

Die Zahl der Linien liefert Gtol.GetSymEdgeCounts an Stelle 0. Anders als Gtol.GetLineAtIndex enthält das Array keine Linienart.

Einheit und Bezugssystem der Koordinaten nennt die Hilfe nicht. Ob die Werte das Symbol in dieser Form- und Lagetoleranz beschreiben oder seine Definition in der Symbolbibliothek, sagt sie ebenfalls nicht; vermutlich die Definition.

Die Werte sind keine Meter, sondern Maße innerhalb des Symbols, bezogen auf eine Symbolhöhe von 1.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

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

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