SolidWorksMakroprogrammierung

Methode · Gtol

ConvertFormat-Methode (Gtol)

Wandelt eine ältere Form- und Lagetoleranz in das aktuelle Format um.

Syntax

Function ConvertFormat() As Long
nFehler = swGtol.ConvertFormat

Rückgabewert

0, wenn die Umwandlung geklappt hat, sonst ein Fehlerwert aus swGtolFormatConversionError_e.

Beispiel

' swGtol ist eine Form- und Lagetoleranz (Gtol), etwa aus der Auswahl.
Dim nFehler As Long
If swGtol.GetFormat = GTOL_SW2021 Then
    If swGtol.CanConvertFormat Then
        nFehler = swGtol.ConvertFormat
        If nFehler = 0 Then
            Debug.Print "Umgewandelt, Format jetzt " & swGtol.GetFormat
        Else
            Debug.Print "Fehler " & nFehler
        End If
    End If
End If

Bemerkungen

Prüfe vorher mit Gtol.CanConvertFormat, ob die Umwandlung möglich ist. Enthält die ältere Toleranz Daten, die das neue Format nicht unterstützt, schlägt der Befehl fehl. Nach der Umwandlung gelten die Befehle für das neue Format wie Gtol.GetFrame, die Befehle für das ältere Format wie Gtol.GetFrameValues nicht mehr.

Im Hilfebeispiel zu GtolFrame ist das Dokument nach einer erfolgreichen Umwandlung als geändert markiert. Das Beispiel speichert es deshalb vor der Umwandlung.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2023

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

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