SolidWorksMakroprogrammierung

Objekt · SldWorks

Gtol-Objekt

Eine Form- und Lagetoleranz als Beschriftung: Toleranzrahmen mit Toleranzart, Toleranzwerten und Bezügen, Zusatztexte, Bezugslinie und die Geometrie ihrer Darstellung.

Deklaration Dim x As SldWorks.Gtol · in der englischen .NET-Hilfe: IGtol

Beschreibung

Gtol liest und setzt die Angaben einer Form- und Lagetoleranz (geometric tolerance, GTol). Eine Form- und Lagetoleranz besteht aus einem oder mehreren Toleranzrahmen untereinander. Ein Rahmen hat Felder: die Toleranzart (etwa Ebenheit oder Position), ein oder zwei Toleranzfelder mit Toleranzwert, Durchmesserzeichen und Materialbedingung und bis zu drei Bezugsfelder für den primären, sekundären und tertiären Bezug. Dazu kommen Texte vor, nach, über und unter den Rahmen, Angaben unter dem Rahmen wie „zwischen zwei Punkten“, „Von–Bis“ oder „getrennte Anforderung“ und die Bezugslinie. Lage, Layer, Sichtbarkeit und Textformat stehen bei der zugehörigen Annotation, die du mit Gtol.GetAnnotation bekommst. Wo die Hilfe eine Version nennt, reicht sie von SOLIDWORKS 98Plus bis 2026 SP02.

Zwei Formate: Seit SOLIDWORKS 2022 speichert SOLIDWORKS Form- und Lagetoleranzen in einem neuen Format (swGtolFormatType_e). Einige Befehle gelten nur für ältere, vor 2022 erstellte Toleranzen, andere nur für das neue Format. Im neuen Format liest und setzt du einen Rahmen über ein GtolFrame-Objekt aus Gtol.GetFrame, das den Rahmen als XML-Text beschreibt.

Zugriff

Beispiel

' Listet alle Form- und Lagetoleranzen der aktiven Zeichnung mit Präfix und Rahmen auf.
' Im neuen Format kommt jeder Rahmen als XML-Text, im älteren Format als Werte.
' Vorbedingung: Eine Zeichnung mit Form- und Lagetoleranzen ist geöffnet.
' Ergebnis:     Die Angaben stehen im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDraw As SldWorks.DrawingDoc
    Dim swView As SldWorks.View
    Dim swGtol As SldWorks.Gtol
    Dim swRahmen As SldWorks.GtolFrame
    Dim vWerte As Variant
    Dim sZeile As String
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then Exit Sub
    Set swDraw = swModel

    Set swView = swDraw.GetFirstView            ' zuerst das Blatt selbst
    Do While Not swView Is Nothing
        Set swGtol = swView.GetFirstGTOL
        Do While Not swGtol Is Nothing
            Debug.Print swView.GetName2 & ": " & swGtol.GetAnnotation.GetName & _
                ", Präfix """ & swGtol.GetText(swGTolTextPrefix) & """"
            If swGtol.GetFormat = GTOL_SW2022 Then
                For i = 1 To swGtol.GetFrameCount
                    Set swRahmen = swGtol.GetFrame(i)
                    If Not swRahmen Is Nothing Then Debug.Print "  Rahmen " & i & ": " & swRahmen.GetSymbolXml
                Next i
            Else
                For i = 1 To swGtol.GetFrameCount - 1   ' so im Hilfebeispiel
                    vWerte = swGtol.GetFrameValues(i)
                    If Not IsEmpty(vWerte) Then
                        sZeile = Join(vWerte, " | ")
                        If Replace(sZeile, " | ", "") <> "" Then Debug.Print "  Rahmen " & i & ": " & sZeile
                    End If
                Next i
            End If
            Set swGtol = swGtol.GetNextGTOL
        Loop
        Set swView = swView.GetNextView
    Loop
End Sub

Bemerkungen

Altes und neues Format: Gtol.GetFrameValues, Gtol.SetFrameValues2, Gtol.GetFrameSymbols3, Gtol.SetFrameSymbols2, Gtol.GetFrameDiameterSymbols, Gtol.GetPTZHeight2 und Gtol.SetPTZHeight2 gelten nur für Form- und Lagetoleranzen, die in einer Version vor SOLIDWORKS 2022 erstellt wurden. Gtol.GetFrame, Gtol.AddFrame und Gtol.DeleteFrame gelten nur für Toleranzen ab 2022. Welches Format eine Toleranz hat, liefert Gtol.GetFormat. Eine ältere Toleranz wandelst du mit Gtol.ConvertFormat um. In welchem Format ModelDoc2.InsertGtol in einer aktuellen Version eine neue Toleranz anlegt, sagt die Hilfe nicht. Die Hilfebeispiele zu InsertGtol stammen aus der Zeit vor 2022 und füllen die Toleranz mit Gtol.SetFrameSymbols2. In SOLIDWORKS 2024 legte InsertGtol eine Toleranz im älteren Format an (GetFormat 1); für sie gelten diese Befehle, und Gtol.ConvertFormat wandelt sie ins neue Format um. Das Format eines Rahmens als XML beschreibt die Hilfe im Kapitel „Gtol Frame XML Schema“, siehe auch SldWorks.GetGtolFrameXMLSchema und SldWorks.GetGtolFormatData.

Symbole als Text: Im älteren Format übergibst du Toleranzart und Materialbedingungen als Kürzel im Format <Bibliothek-Symbol>, etwa <IGTOL-POSI> für Position aus der ISO-Bibliothek oder <MOD-MMC> für die Maximum-Material-Bedingung. Die Symbole stehen in der Datei gtol.sym im Ordner C:\ProgramData\SolidWorks\SolidWorks 20nn\lang\english.

Rahmennummer: Die Hilfe zählt die Rahmen ab 1. Bei Gtol.GetFrameValues, Gtol.GetFrameSymbols3 und Gtol.GetFrameDiameterSymbols nennt sie nur die Rahmen 1 oder 2, die Hilfe zu Gtol.GetFrameCount gibt aber an, dass eine Toleranz mehr Rahmen speichern kann, darunter auch leere. Das Hilfebeispiel „Get Text Items in GTol Frame“ liest im älteren Format nur die Rahmen 1 bis GetFrameCount − 1, ohne zu sagen, warum. Das Beispiel oben macht es genauso.

Bezugslinie: Ringsum und überall gelten nur für geknickte und senkrechte Bezugslinien sowie für Bezugslinien mit mehreren Knicken. Solche Bezugslinien legst du mit Annotation.SetLeader3 an. Die einfache Bezugslinie mit Seite, Knick und Ringsum-Symbol setzt Gtol.SetLeader.

Neu zeichnen: Nach Gtol.SetText musst du mit ModelView.GraphicsRedraw neu zeichnen, damit der neue Text zu sehen ist. Die Hilfebeispiele zum Einfügen rufen am Ende ModelDoc2.WindowRedraw auf.

Einheiten: Gtol.Angle ist in Bogenmaß und Gtol.GetTextHeightAtIndex in Metern. Bei den übrigen Koordinaten nennt die Hilfe keine Einheit. Lage, Bezugslinien, Pfeile und Linien sind in Meter; die Symbol-Befehle GetSymLines, GetSymCircles usw. liefern dagegen Maße im Symbol.

PMI-Toleranzen: Form- und Lagetoleranzen, die SOLIDWORKS aus importierten STEP-242-Dateien als PMI-Daten übernimmt, liest du nicht über Gtol, sondern mit Annotation.GetPMIData als PMIGtolData mit PMIFrameData, PMIGtolBoxData und PMIGtolFrameDatum. Besteht eine Beschriftung nur aus PMI-Daten, liefert Annotation.GetSpecificAnnotation Nothing.

Variablenname: VBA unterscheidet Groß- und Kleinschreibung nicht. Die Variable swGtol hat deshalb denselben Namen wie die Konstante swGTol aus swAnnotationType_e. Brauchst du im selben Makro beides, etwa für Annotation.GetType = swGTol, nenn die Variable anders, zum Beispiel swToleranz.

Eigenschaften und Methoden

Eigenschaften 2, davon 2 beschrieben

NameBeschreibung
AngleLiest oder setzt den Drehwinkel der Form- und Lagetoleranz, in Bogenmaß.
SeparateRequirementLiest oder setzt, ob unter dem Toleranzrahmen die Angabe „SEP REQT“ (getrennte Anforderung) steht.

Methoden 92, davon 80 beschrieben, 12 veraltet

NameBeschreibung
AddFrameHängt einen neuen Toleranzrahmen ans Ende der Rahmen der Form- und Lagetoleranz an. Nur im neuen Format ab SOLIDWORKS 2022.
CanConvertFormatLiefert, ob sich die Form- und Lagetoleranz in das aktuelle Format umwandeln lässt.
ConvertFormatWandelt eine ältere Form- und Lagetoleranz in das aktuelle Format um.
DeleteBelowFrameTextAtLöscht eine Zeile oder alle Zeilen des Texts unter dem Toleranzrahmen.
DeleteFrameLöscht einen Toleranzrahmen aus der Form- und Lagetoleranz. Nur im neuen Format ab SOLIDWORKS 2022.
GetAllAroundLiefert, ob die Bezugslinie der Form- und Lagetoleranz das Symbol „ringsum“ trägt.
GetAllAroundThisSideLiefert, ob die Bezugslinie der Form- und Lagetoleranz das Symbol „ringsum auf dieser Seite“ trägt.
GetAllOverLiefert, ob die Bezugslinie der Form- und Lagetoleranz das Symbol „überall“ trägt.
GetAllOverThisSideLiefert, ob die Bezugslinie der Form- und Lagetoleranz das Symbol „überall auf dieser Seite“ trägt.
GetAnnotationLiefert die Beschriftung (Annotation) zur Form- und Lagetoleranz, mit Lage, Layer, Bezugslinien und Textformat.
GetArcAtIndexLiefert Linientyp, Anfangs-, End- und Mittelpunkt und Drehsinn eines Bogens in der Darstellung der Form- und Lagetoleranz.
GetArcCountLiefert die Zahl der Bögen in der Darstellung der Form- und Lagetoleranz.
GetArrowHeadAtIndexLiefert Spitze, Richtung, Maße und Art einer Pfeilspitze in der Darstellung der Form- und Lagetoleranz.
GetArrowHeadCountLiefert die Zahl der Pfeilspitzen in der Darstellung der Form- und Lagetoleranz.
GetArrowHeadInfoLiefert Länge, Maße und Art der Pfeilspitze am fernen Ende der Bezugslinie.
GetAttachPosLiefert den Anhängepunkt der Form- und Lagetoleranz, also wo ihre Bezugslinie am Modell ansetzt.
GetBelowFrameTextAtLiefert eine Zeile des Texts unter dem Toleranzrahmen.
GetBelowFrameTextLineCountLiefert die Zahl der Zeilen im Text unter dem Toleranzrahmen.
GetBetweenTwoPointsLiefert, ob die Form- und Lagetoleranz das Symbol „zwischen zwei Punkten“ zeigt.
GetBetweenTwoPointsTextLiefert den Text am linken oder rechten Ende des Symbols „zwischen zwei Punkten“.
GetCompositeFrameveraltet ersetzt durch Gtol.GetCompositeFrame2
GetCompositeFrame2Liefert, ob ein Toleranzrahmen zu einem zusammengesetzten Rahmen gehört.
GetDatumIdentifierLiefert das Bezugskennzeichen (datum identifier) der Form- und Lagetoleranz.
GetDisplayDualDimensionInRangeValuesLiefert, ob die Form- und Lagetoleranz bei Bereichswerten die Doppelbemaßung (zweite Einheit) anzeigt.
GetFontInfoLiefert zurzeit nur den Linientyp der Form- und Lagetoleranz, keine Schriftangaben.
GetFormatLiefert das Format der Form- und Lagetoleranz: das ältere bis SOLIDWORKS 2021 oder das neue ab 2022.
GetFrameLiefert einen Toleranzrahmen als GtolFrame-Objekt. Nur im neuen Format ab SOLIDWORKS 2022.
GetFrameCountLiefert die Zahl der gespeicherten Toleranzrahmen der Form- und Lagetoleranz.
GetFrameDiameterSymbolsLiefert, ob die beiden Toleranzwerte eines Rahmens ein Durchmesserzeichen haben. Nur im älteren Format vor SOLIDWORKS 2022.
GetFrameSymbolsveraltet ersetzt durch Gtol.GetFrameSymbols3
GetFrameSymbols2veraltet ersetzt durch Gtol.GetFrameSymbols3
GetFrameSymbols3Liefert Toleranzsymbol und Materialbedingungen eines Rahmens als Symbolkürzel. Nur im älteren Format vor SOLIDWORKS 2022.
GetFrameValuesLiefert die Texte in den Toleranz- und Bezugsfeldern eines Rahmens. Nur im älteren Format vor SOLIDWORKS 2022.
GetFromToLiefert, ob die Form- und Lagetoleranz unter dem Rahmen das Symbol „Von–Bis“ hat.
GetFromToTextLiefert die beiden Texte des Symbols „Von–Bis“ unter dem Toleranzrahmen.
GetHeightLiefert die Höhe der Form- und Lagetoleranz.
GetLeaderAtIndexveraltet ersetzt durch Gtol.GetLeaderAtIndex2
GetLeaderAtIndex2Liefert die Eckpunkte einer Bezugslinie der Form- und Lagetoleranz, auch bei senkrechten Bezugslinien.
GetLeaderCountLiefert die Zahl der Bezugslinien an der Form- und Lagetoleranz.
GetLeaderInfoLiefert die Punkte der Bezugslinie der Form- und Lagetoleranz, ohne Index.
GetLeaderSideLiefert, an welcher Seite die Bezugslinie an der Form- und Lagetoleranz ansetzt.
GetLineAtIndexLiefert Linientyp, Anfangs- und Endpunkt einer Linie in der Darstellung der Form- und Lagetoleranz.
GetLineCountLiefert die Zahl der Linien in der Darstellung der Form- und Lagetoleranz.
GetNextGTOLLiefert die nächste Form- und Lagetoleranz der Zeichenansicht, für eine Schleife über alle Form- und Lagetoleranzen.
GetPTZHeightveraltet ersetzt durch Gtol.GetPTZHeight2
GetPTZHeight2Liefert, ob ein Toleranzwert eine projizierte Toleranzzone hat, und deren Höhe. Nur im älteren Format vor SOLIDWORKS 2022.
GetSymArcsLiefert Mittel-, Anfangs- und Endpunkt aller Bögen eines Toleranzsymbols, etwa des Symbols für Ebenheit.
GetSymCirclesLiefert Radius und Mittelpunkt aller Kreise eines Toleranzsymbols, etwa des Symbols für Position.
GetSymDescLiefert die Beschreibung eines Toleranzsymbols.
GetSymEdgeCountsLiefert, wie viele Linien, Bögen, Kreise und Texte ein Toleranzsymbol hat.
GetSymLinesLiefert Anfangs- und Endpunkt aller Linien eines Toleranzsymbols, etwa des Symbols für Ebenheit.
GetSymNameLiefert den Namen eines Toleranzsymbols zu seiner Nummer, etwa für Ebenheit oder Position.
GetSymTextLiefert die Texte eines Toleranzsymbols.
GetSymTextPointsLiefert die Lage der Texte eines Toleranzsymbols.
GetTextLiefert einen Zusatztext der Form- und Lagetoleranz: Präfix, Suffix, Text darüber oder darunter.
GetTextAngleAtIndexLiefert den Winkel eines Textstücks in der Darstellung der Form- und Lagetoleranz.
GetTextAtIndexLiefert ein Textstück aus der Darstellung der Form- und Lagetoleranz.
GetTextCountLiefert die Zahl der Textstücke in der Darstellung der Form- und Lagetoleranz.
GetTextFontLiefert den Namen der Schrift der Form- und Lagetoleranz.
GetTextFormatveraltet ersetzt durch Annotation.GetTextFormat
GetTextHeightAtIndexLiefert die Schrifthöhe eines Textstücks in der Darstellung der Form- und Lagetoleranz.
GetTextInvertAtIndexLiefert, ob ein Textstück in der Darstellung der Form- und Lagetoleranz an der X-Achse gespiegelt ist.
GetTextPointLiefert den Bezugspunkt der Texte der Form- und Lagetoleranz: die linke obere Ecke ihres umschließenden Rechtecks.
GetTextPositionAtIndexLiefert die Lage eines Textstücks relativ zum Ursprung der Form- und Lagetoleranz.
GetTextRefPositionAtIndexLiefert, auf welchen Punkt eines Textstücks sich seine Lage bezieht, etwa oben links oder Mitte.
GetTriangleAtIndexLiefert die Eckpunkte, die Füllung und den Linientyp eines Dreiecks in der Darstellung der Form- und Lagetoleranz.
GetTriangleCountLiefert die Zahl der Dreiecke in der Darstellung der Form- und Lagetoleranz.
GetUseDocTextFormatveraltet ersetzt durch Annotation.GetUseDocTextFormat
GetWitnessLineLiefert Anfangs- und Endpunkt der Hilfslinie, die die Bezugslinie der Form- und Lagetoleranz mit dem tolerierten Element verbindet.
HasExtraLeaderLiefert, ob die Bezugslinie der Form- und Lagetoleranz geknickt ist, also eine zusätzliche Linie hat.
InsertBelowFrameTextAtFügt eine Zeile in den Text unter dem Toleranzrahmen ein.
IsAttachedLiefert, ob die Form- und Lagetoleranz mit einer Bezugslinie angehängt ist.
SetAllAroundThisSideLegt fest, ob die Bezugslinie der Form- und Lagetoleranz das Symbol „ringsum auf dieser Seite“ trägt.
SetAllOverLegt fest, ob die Bezugslinie der Form- und Lagetoleranz das Symbol „überall“ trägt.
SetAllOverThisSideLegt fest, ob die Bezugslinie der Form- und Lagetoleranz das Symbol „überall auf dieser Seite“ trägt.
SetBelowFrameTextAtÄndert eine Zeile des Texts unter dem Toleranzrahmen oder fügt eine neue ein.
SetBetweenTwoPointsSchaltet das Symbol „zwischen zwei Punkten“ mit seinen beiden Texten ein oder aus.
SetCompositeFrameveraltet ersetzt durch Gtol.SetCompositeFrame2
SetCompositeFrame2Fasst einen Toleranzrahmen und den Rahmen darunter zu einem zusammengesetzten Rahmen zusammen.
SetDatumIdentifierSetzt das Bezugskennzeichen (datum identifier) der Form- und Lagetoleranz.
SetDisplayDualDimensionInRangeValuesLegt fest, ob die Form- und Lagetoleranz bei Bereichswerten die Doppelbemaßung (zweite Einheit) anzeigt.
SetFrameSymbolsveraltet ersetzt durch Gtol.SetFrameSymbols2
SetFrameSymbols2Setzt Toleranzsymbol, Durchmesserzeichen und Materialbedingungen eines Rahmens. Nur im älteren Format vor SOLIDWORKS 2022.
SetFrameValuesveraltet ersetzt durch Gtol.SetFrameValues2
SetFrameValues2Setzt Toleranzwerte und Bezüge eines Rahmens. Nur im älteren Format vor SOLIDWORKS 2022.
SetFromToTextFügt unter dem Toleranzrahmen das Symbol „Von–Bis“ ein und setzt seine beiden Texte.
SetLeaderStellt die Bezugslinie der Form- und Lagetoleranz ein: ein oder aus, Seite, geknickt und „ringsum“.
SetPositionSetzt die Lage der Form- und Lagetoleranz.
SetPTZHeightveraltet ersetzt durch Gtol.SetPTZHeight2
SetPTZHeight2Schaltet für einen Toleranzwert die projizierte Toleranzzone ein oder aus und setzt deren Höhe. Nur im älteren Format vor SOLIDWORKS 2022.
SetTextSetzt einen Zusatztext der Form- und Lagetoleranz: Präfix, Suffix, Text darüber oder darunter.
SetTextFormatveraltet ersetzt durch Annotation.SetTextFormat

Nicht aufgeführt sind 27 C++-Varianten (Namen mit I davor, zum Beispiel IGetAnnotation). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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