Objekt · SldWorks
GtolFrame-Objekt
Ein Toleranzrahmen einer Form- und Lagetoleranz im neuen Format ab SOLIDWORKS 2022: der Rahmen als XML-Text, seine Toleranzart und die Indikatoren rechts vom Rahmen.
Beschreibung
GtolFrame gibt Zugriff auf die Indikatoren und den XML-Text eines Toleranzrahmens (feature control frame) einer Gtol. GtolFrame erweitert Gtol um das neue Format, in dem SOLIDWORKS seit 2022 Form- und Lagetoleranzen speichert. Im neuen Format beschreibst du einen Rahmen als XML-Text: Toleranzart, Toleranzwerte und -zone, Filter, Materialbedingungen und Bezüge. Die Befehle gibt es seit SOLIDWORKS 2023.
Für die Teile eines Rahmens gilt:
- Links von der Toleranz: eine Zeile Text mit Symbol, nur beim ersten Rahmen
- Über der Toleranz: mehrzeiliger Text mit Symbol, nur beim obersten Rahmen
- Rechts von der Toleranz: Indikatoren, Bezug oder Textfeld. Es sind mehrere Indikatoren möglich, ein Textfeld muss aber am Ende der Indikatoren stehen und hat nur eine Zeile mit Symbol.
- Unter der Toleranz: weitere Rahmen, Text, „zwischen zwei Punkten“, „Von–Bis“ und „getrennte Anforderung“, nur beim untersten Rahmen
Zugriff
Gtol.GetFrame: ein Rahmen einer Form- und Lagetoleranz im neuen Format, gezählt ab1bisGtol.GetFrameCount
Einen neuen Rahmen hängst du mit Gtol.AddFrame an und holst ihn dann mit GetFrame(GetFrameCount), so im Hilfebeispiel. Das Format einer Toleranz liefert Gtol.GetFormat, eine ältere Toleranz wandelst du mit Gtol.ConvertFormat um.
Beispiel
' Gibt für jeden Rahmen der ausgewählten Form- und Lagetoleranz den XML-Text,
' die Toleranzart und die Indikatoren aus.
' Vorbedingung: Eine Zeichnung ist offen, eine Form- und Lagetoleranz im neuen
' Format (ab SOLIDWORKS 2022) ist ausgewählt.
' Ergebnis: Die Angaben stehen im Direktfenster (Strg+G).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSelMgr As SldWorks.SelectionMgr
Dim swGtol As SldWorks.Gtol
Dim swRahmen As SldWorks.GtolFrame
Dim nArt As Long
Dim nRand As Long
Dim sBezug As String
Dim i As Long
Dim j As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSelMgr = swModel.SelectionManager
Set swGtol = swSelMgr.GetSelectedObject6(1, -1)
If swGtol Is Nothing Then Exit Sub
If swGtol.GetFormat <> GTOL_SW2022 Then
Debug.Print "Die Toleranz hat das ältere Format."
Exit Sub
End If
For i = 1 To swGtol.GetFrameCount
Set swRahmen = swGtol.GetFrame(i)
If Not swRahmen Is Nothing Then
Debug.Print "Rahmen " & i & ": " & swRahmen.GetSymbolXml
If swRahmen.GetFrameToleranceType(nArt) Then
Debug.Print " Toleranzart (swGtolGeomCharSymbol_e): " & nArt
End If
For j = 1 To swRahmen.GetIndicatorCount
If swRahmen.GetIndicator(j, nRand, nArt, sBezug) Then
Debug.Print " Indikator " & j & ": Art " & nRand & _
", Toleranzart " & nArt & ", Bezug " & sBezug
End If
Next j
End If
Next i
End SubBemerkungen
XML-Text: GtolFrame.GetSymbolXml und GtolFrame.SetSymbolXml gelten nur für Form- und Lagetoleranzen, die im Format von SOLIDWORKS 2022 erstellt oder in dieses Format umgewandelt wurden. Den Aufbau beschreibt die Hilfe im Kapitel „Gtol Frame XML Schema“ des Programmierhandbuchs. Der oberste Knoten ist <GtolFrame>, Pflicht sind <ToleranceSymbol> und <PrimaryToleranceValue>. Fehlt ein Knoten, gelten für seinen Bereich die Vorgaben. Die Toleranzart steht im Format Bibliothek-Symbol ohne spitze Klammern, etwa <ToleranceSymbol>IGTOL-FLAT</ToleranceSymbol> für Ebenheit aus der ISO-Bibliothek. Ein leeres <ToleranceSymbol> bedeutet, dass der Rahmen mit dem darüber einen zusammengesetzten Rahmen bildet. SOLIDWORKS prüft den Text, den du an SetSymbolXml übergibst, gegen die Schemadatei (*.xsd) im Ordner data\xmlschema der Installation. Das Schema als Text liefert SldWorks.GetGtolFrameXMLSchema, Format und Schemaversion liefert SldWorks.GetGtolFormatData.
Indikatoren: Indikatoren legen eine Toleranzzone fest, in der der Toleranzwert gilt. Sie stehen rechts vom Rahmen, beim ersten Rahmen links von einem Textfeld. Ein Indikator hat eine Art aus swGtolIndicatorBorderType_e (dem Namen nach Schnittebene, Orientierungsebene, Kollektionsebene oder Richtungselement), eine Toleranzart und einen Bezugsbuchstaben. Als Toleranzart nennt die Hilfe nur swGcsANG, swGcsPARALLEL, swGcsPERP, swGcsCIRCRUNOUT und swGcsSYMMETRY aus swGtolGeomCharSymbol_e. Im Hilfebeispiel liefert GtolFrame.AddIndicator mit swGcsFLAT False. Die Indikatoren zählst du ab 1, die Zahl liefert GtolFrame.GetIndicatorCount.
Toleranzart des Rahmens: Bei GtolFrame.GetFrameToleranceType und GtolFrame.SetFrameToleranceType nennt die Hilfe dieselben fünf Toleranzarten wie bei den Indikatoren. Das Hilfebeispiel setzt mit SetFrameToleranceType aber swGcsROUND (Rundheit). Was davon stimmt, ist offen.
Änderungen: Ob nach den Set-, Add- und Delete-Befehlen ein Neuzeichnen nötig ist, sagt die Hilfe nicht. Das Hilfebeispiel ruft danach nichts weiter auf.
GtolFrame.GetFrameToleranceType liefert auch Toleranzarten außerhalb der fünf genannten, etwa swGcsPOSITION (23) für einen Positionsrahmen.
Eigenschaften und Methoden
Methoden 9, davon 9 beschrieben
| Name | Beschreibung |
|---|---|
| AddIndicator | Hängt einen Indikator ans Ende der Indikatoren rechts vom Toleranzrahmen an. |
| DeleteIndicator | Löscht einen Indikator des Toleranzrahmens. |
| GetFrameToleranceType | Liefert die Toleranzart des Toleranzrahmens. |
| GetIndicator | Liefert Art, Toleranzart und Bezug eines Indikators des Toleranzrahmens. |
| GetIndicatorCount | Liefert die Zahl der Indikatoren des Toleranzrahmens. |
| GetSymbolXml | Liefert den Toleranzrahmen als XML-Text. |
| SetFrameToleranceType | Setzt die Toleranzart des Toleranzrahmens. |
| SetIndicator | Setzt Art, Toleranzart und Bezug eines vorhandenen Indikators rechts vom Toleranzrahmen. |
| SetSymbolXml | Setzt den Toleranzrahmen aus einem XML-Text. |
Siehe auch
Englisches Original: IGtolFrame in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.