SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.GtolFrame · in der englischen .NET-Hilfe: IGtolFrame

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

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 Sub

Bemerkungen

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

NameBeschreibung
AddIndicatorHängt einen Indikator ans Ende der Indikatoren rechts vom Toleranzrahmen an.
DeleteIndicatorLöscht einen Indikator des Toleranzrahmens.
GetFrameToleranceTypeLiefert die Toleranzart des Toleranzrahmens.
GetIndicatorLiefert Art, Toleranzart und Bezug eines Indikators des Toleranzrahmens.
GetIndicatorCountLiefert die Zahl der Indikatoren des Toleranzrahmens.
GetSymbolXmlLiefert den Toleranzrahmen als XML-Text.
SetFrameToleranceTypeSetzt die Toleranzart des Toleranzrahmens.
SetIndicatorSetzt Art, Toleranzart und Bezug eines vorhandenen Indikators rechts vom Toleranzrahmen.
SetSymbolXmlSetzt 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.