Objekt · SldWorks
Gtol-Objekt
Eine Form- und Lagetoleranz als Beschriftung: Toleranzrahmen mit Toleranzart, Toleranzwerten und Bezügen, Zusatztexte, Bezugslinie und die Geometrie ihrer Darstellung.
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
ModelDoc2.InsertGtol: fügt eine leere Form- und Lagetoleranz ein, bei einer Auswahl mit BezugslinieDrawingDoc.NewGtol: eine neue Form- und Lagetoleranz in einer ZeichnungDrawingDoc.EditSelectedGtol: die ausgewählte Form- und Lagetoleranz zum BearbeitenView.GetFirstGTOLund dannGtol.GetNextGTOL: alle Form- und Lagetoleranzen einer ZeichenansichtView.GetGTolsundView.GetGTolCount: alle Form- und Lagetoleranzen einer Zeichenansicht als Array und ihre AnzahlAnnotation.GetSpecificAnnotation: aus einer Beschriftung, wennAnnotation.GetTypeswGTol(swAnnotationType_e) liefertSelectionMgr.GetSelectedObject6: eine ausgewählte Form- und Lagetoleranz, so in den Hilfebeispielen
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Angle | Liest oder setzt den Drehwinkel der Form- und Lagetoleranz, in Bogenmaß. |
| SeparateRequirement | Liest oder setzt, ob unter dem Toleranzrahmen die Angabe „SEP REQT“ (getrennte Anforderung) steht. |
Methoden 92, davon 80 beschrieben, 12 veraltet
| Name | Beschreibung |
|---|---|
| AddFrame | Hängt einen neuen Toleranzrahmen ans Ende der Rahmen der Form- und Lagetoleranz an. Nur im neuen Format ab SOLIDWORKS 2022. |
| CanConvertFormat | Liefert, ob sich die Form- und Lagetoleranz in das aktuelle Format umwandeln lässt. |
| ConvertFormat | Wandelt eine ältere Form- und Lagetoleranz in das aktuelle Format um. |
| DeleteBelowFrameTextAt | Löscht eine Zeile oder alle Zeilen des Texts unter dem Toleranzrahmen. |
| DeleteFrame | Löscht einen Toleranzrahmen aus der Form- und Lagetoleranz. Nur im neuen Format ab SOLIDWORKS 2022. |
| GetAllAround | Liefert, ob die Bezugslinie der Form- und Lagetoleranz das Symbol „ringsum“ trägt. |
| GetAllAroundThisSide | Liefert, ob die Bezugslinie der Form- und Lagetoleranz das Symbol „ringsum auf dieser Seite“ trägt. |
| GetAllOver | Liefert, ob die Bezugslinie der Form- und Lagetoleranz das Symbol „überall“ trägt. |
| GetAllOverThisSide | Liefert, ob die Bezugslinie der Form- und Lagetoleranz das Symbol „überall auf dieser Seite“ trägt. |
| GetAnnotation | Liefert die Beschriftung (Annotation) zur Form- und Lagetoleranz, mit Lage, Layer, Bezugslinien und Textformat. |
| GetArcAtIndex | Liefert Linientyp, Anfangs-, End- und Mittelpunkt und Drehsinn eines Bogens in der Darstellung der Form- und Lagetoleranz. |
| GetArcCount | Liefert die Zahl der Bögen in der Darstellung der Form- und Lagetoleranz. |
| GetArrowHeadAtIndex | Liefert Spitze, Richtung, Maße und Art einer Pfeilspitze in der Darstellung der Form- und Lagetoleranz. |
| GetArrowHeadCount | Liefert die Zahl der Pfeilspitzen in der Darstellung der Form- und Lagetoleranz. |
| GetArrowHeadInfo | Liefert Länge, Maße und Art der Pfeilspitze am fernen Ende der Bezugslinie. |
| GetAttachPos | Liefert den Anhängepunkt der Form- und Lagetoleranz, also wo ihre Bezugslinie am Modell ansetzt. |
| GetBelowFrameTextAt | Liefert eine Zeile des Texts unter dem Toleranzrahmen. |
| GetBelowFrameTextLineCount | Liefert die Zahl der Zeilen im Text unter dem Toleranzrahmen. |
| GetBetweenTwoPoints | Liefert, ob die Form- und Lagetoleranz das Symbol „zwischen zwei Punkten“ zeigt. |
| GetBetweenTwoPointsText | Liefert den Text am linken oder rechten Ende des Symbols „zwischen zwei Punkten“. |
| GetCompositeFrame | veraltet ersetzt durch Gtol.GetCompositeFrame2 |
| GetCompositeFrame2 | Liefert, ob ein Toleranzrahmen zu einem zusammengesetzten Rahmen gehört. |
| GetDatumIdentifier | Liefert das Bezugskennzeichen (datum identifier) der Form- und Lagetoleranz. |
| GetDisplayDualDimensionInRangeValues | Liefert, ob die Form- und Lagetoleranz bei Bereichswerten die Doppelbemaßung (zweite Einheit) anzeigt. |
| GetFontInfo | Liefert zurzeit nur den Linientyp der Form- und Lagetoleranz, keine Schriftangaben. |
| GetFormat | Liefert das Format der Form- und Lagetoleranz: das ältere bis SOLIDWORKS 2021 oder das neue ab 2022. |
| GetFrame | Liefert einen Toleranzrahmen als GtolFrame-Objekt. Nur im neuen Format ab SOLIDWORKS 2022. |
| GetFrameCount | Liefert die Zahl der gespeicherten Toleranzrahmen der Form- und Lagetoleranz. |
| GetFrameDiameterSymbols | Liefert, ob die beiden Toleranzwerte eines Rahmens ein Durchmesserzeichen haben. Nur im älteren Format vor SOLIDWORKS 2022. |
| GetFrameSymbols | veraltet ersetzt durch Gtol.GetFrameSymbols3 |
| GetFrameSymbols2 | veraltet ersetzt durch Gtol.GetFrameSymbols3 |
| GetFrameSymbols3 | Liefert Toleranzsymbol und Materialbedingungen eines Rahmens als Symbolkürzel. Nur im älteren Format vor SOLIDWORKS 2022. |
| GetFrameValues | Liefert die Texte in den Toleranz- und Bezugsfeldern eines Rahmens. Nur im älteren Format vor SOLIDWORKS 2022. |
| GetFromTo | Liefert, ob die Form- und Lagetoleranz unter dem Rahmen das Symbol „Von–Bis“ hat. |
| GetFromToText | Liefert die beiden Texte des Symbols „Von–Bis“ unter dem Toleranzrahmen. |
| GetHeight | Liefert die Höhe der Form- und Lagetoleranz. |
| GetLeaderAtIndex | veraltet ersetzt durch Gtol.GetLeaderAtIndex2 |
| GetLeaderAtIndex2 | Liefert die Eckpunkte einer Bezugslinie der Form- und Lagetoleranz, auch bei senkrechten Bezugslinien. |
| GetLeaderCount | Liefert die Zahl der Bezugslinien an der Form- und Lagetoleranz. |
| GetLeaderInfo | Liefert die Punkte der Bezugslinie der Form- und Lagetoleranz, ohne Index. |
| GetLeaderSide | Liefert, an welcher Seite die Bezugslinie an der Form- und Lagetoleranz ansetzt. |
| GetLineAtIndex | Liefert Linientyp, Anfangs- und Endpunkt einer Linie in der Darstellung der Form- und Lagetoleranz. |
| GetLineCount | Liefert die Zahl der Linien in der Darstellung der Form- und Lagetoleranz. |
| GetNextGTOL | Liefert die nächste Form- und Lagetoleranz der Zeichenansicht, für eine Schleife über alle Form- und Lagetoleranzen. |
| GetPTZHeight | veraltet ersetzt durch Gtol.GetPTZHeight2 |
| GetPTZHeight2 | Liefert, ob ein Toleranzwert eine projizierte Toleranzzone hat, und deren Höhe. Nur im älteren Format vor SOLIDWORKS 2022. |
| GetSymArcs | Liefert Mittel-, Anfangs- und Endpunkt aller Bögen eines Toleranzsymbols, etwa des Symbols für Ebenheit. |
| GetSymCircles | Liefert Radius und Mittelpunkt aller Kreise eines Toleranzsymbols, etwa des Symbols für Position. |
| GetSymDesc | Liefert die Beschreibung eines Toleranzsymbols. |
| GetSymEdgeCounts | Liefert, wie viele Linien, Bögen, Kreise und Texte ein Toleranzsymbol hat. |
| GetSymLines | Liefert Anfangs- und Endpunkt aller Linien eines Toleranzsymbols, etwa des Symbols für Ebenheit. |
| GetSymName | Liefert den Namen eines Toleranzsymbols zu seiner Nummer, etwa für Ebenheit oder Position. |
| GetSymText | Liefert die Texte eines Toleranzsymbols. |
| GetSymTextPoints | Liefert die Lage der Texte eines Toleranzsymbols. |
| GetText | Liefert einen Zusatztext der Form- und Lagetoleranz: Präfix, Suffix, Text darüber oder darunter. |
| GetTextAngleAtIndex | Liefert den Winkel eines Textstücks in der Darstellung der Form- und Lagetoleranz. |
| GetTextAtIndex | Liefert ein Textstück aus der Darstellung der Form- und Lagetoleranz. |
| GetTextCount | Liefert die Zahl der Textstücke in der Darstellung der Form- und Lagetoleranz. |
| GetTextFont | Liefert den Namen der Schrift der Form- und Lagetoleranz. |
| GetTextFormat | veraltet ersetzt durch Annotation.GetTextFormat |
| GetTextHeightAtIndex | Liefert die Schrifthöhe eines Textstücks in der Darstellung der Form- und Lagetoleranz. |
| GetTextInvertAtIndex | Liefert, ob ein Textstück in der Darstellung der Form- und Lagetoleranz an der X-Achse gespiegelt ist. |
| GetTextPoint | Liefert den Bezugspunkt der Texte der Form- und Lagetoleranz: die linke obere Ecke ihres umschließenden Rechtecks. |
| GetTextPositionAtIndex | Liefert die Lage eines Textstücks relativ zum Ursprung der Form- und Lagetoleranz. |
| GetTextRefPositionAtIndex | Liefert, auf welchen Punkt eines Textstücks sich seine Lage bezieht, etwa oben links oder Mitte. |
| GetTriangleAtIndex | Liefert die Eckpunkte, die Füllung und den Linientyp eines Dreiecks in der Darstellung der Form- und Lagetoleranz. |
| GetTriangleCount | Liefert die Zahl der Dreiecke in der Darstellung der Form- und Lagetoleranz. |
| GetUseDocTextFormat | veraltet ersetzt durch Annotation.GetUseDocTextFormat |
| GetWitnessLine | Liefert Anfangs- und Endpunkt der Hilfslinie, die die Bezugslinie der Form- und Lagetoleranz mit dem tolerierten Element verbindet. |
| HasExtraLeader | Liefert, ob die Bezugslinie der Form- und Lagetoleranz geknickt ist, also eine zusätzliche Linie hat. |
| InsertBelowFrameTextAt | Fügt eine Zeile in den Text unter dem Toleranzrahmen ein. |
| IsAttached | Liefert, ob die Form- und Lagetoleranz mit einer Bezugslinie angehängt ist. |
| SetAllAroundThisSide | Legt fest, ob die Bezugslinie der Form- und Lagetoleranz das Symbol „ringsum auf dieser Seite“ trägt. |
| SetAllOver | Legt fest, ob die Bezugslinie der Form- und Lagetoleranz das Symbol „überall“ trägt. |
| SetAllOverThisSide | Legt 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. |
| SetBetweenTwoPoints | Schaltet das Symbol „zwischen zwei Punkten“ mit seinen beiden Texten ein oder aus. |
| SetCompositeFrame | veraltet ersetzt durch Gtol.SetCompositeFrame2 |
| SetCompositeFrame2 | Fasst einen Toleranzrahmen und den Rahmen darunter zu einem zusammengesetzten Rahmen zusammen. |
| SetDatumIdentifier | Setzt das Bezugskennzeichen (datum identifier) der Form- und Lagetoleranz. |
| SetDisplayDualDimensionInRangeValues | Legt fest, ob die Form- und Lagetoleranz bei Bereichswerten die Doppelbemaßung (zweite Einheit) anzeigt. |
| SetFrameSymbols | veraltet ersetzt durch Gtol.SetFrameSymbols2 |
| SetFrameSymbols2 | Setzt Toleranzsymbol, Durchmesserzeichen und Materialbedingungen eines Rahmens. Nur im älteren Format vor SOLIDWORKS 2022. |
| SetFrameValues | veraltet ersetzt durch Gtol.SetFrameValues2 |
| SetFrameValues2 | Setzt Toleranzwerte und Bezüge eines Rahmens. Nur im älteren Format vor SOLIDWORKS 2022. |
| SetFromToText | Fügt unter dem Toleranzrahmen das Symbol „Von–Bis“ ein und setzt seine beiden Texte. |
| SetLeader | Stellt die Bezugslinie der Form- und Lagetoleranz ein: ein oder aus, Seite, geknickt und „ringsum“. |
| SetPosition | Setzt die Lage der Form- und Lagetoleranz. |
| SetPTZHeight | veraltet ersetzt durch Gtol.SetPTZHeight2 |
| SetPTZHeight2 | Schaltet für einen Toleranzwert die projizierte Toleranzzone ein oder aus und setzt deren Höhe. Nur im älteren Format vor SOLIDWORKS 2022. |
| SetText | Setzt einen Zusatztext der Form- und Lagetoleranz: Präfix, Suffix, Text darüber oder darunter. |
| SetTextFormat | veraltet 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.