SolidWorksMakroprogrammierung

Objekt · SldWorks

PMIGtolBoxData-Objekt

Ein Toleranzfeld im Toleranzrahmen einer Form- und Lagetoleranz aus PMI-Daten: Toleranzwert, Einheit, Materialbedingung, Toleranzzone und Zusatzsymbole.

Deklaration Dim x As SldWorks.PMIGtolBoxData · in der englischen .NET-Hilfe: IPMIGtolBoxData

Beschreibung

PMIGtolBoxData gibt Zugriff auf ein Toleranzfeld (tolerance box) einer Form- und Lagetoleranz aus PMI-Daten (Product and Manufacturing Information). Solche Daten übernimmt SOLIDWORKS aus importierten STEP-242-Dateien. Ein Toleranzrahmen enthält bis zu drei Toleranzfelder und bis zu drei Bezugsfelder (PMIGtolFrameDatum). Alle Befehle lesen nur. Die Befehle gibt es seit SOLIDWORKS 2019.

Zugriff

Der Weg dorthin: ModelDocExtension.GetAnnotations liefert die Beschriftungen eines Teils aus einer STEP-242-Datei. Liefert Annotation.GetPMIType swPMIType_GTol, gibt Annotation.GetPMIData ein PMIGtolData zurück. Dessen Rahmen (PMIFrameData) holst du mit PMIGtolData.GetFrameAtIndex.

Beispiel

' Gibt für jede Form- und Lagetoleranz aus PMI-Daten die Toleranzfelder jedes
' Toleranzrahmens mit Wert, Einheit, Toleranzzone und Materialbedingung aus.
' Vorbedingung: Ein Teil aus einer STEP-242-Datei mit PMI-Beschriftungen ist offen.
' Ergebnis:     Die Toleranzfelder stehen im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swAnn As SldWorks.Annotation
    Dim swToleranz As SldWorks.PMIGtolData
    Dim swRahmen As SldWorks.PMIFrameData
    Dim swFeld As SldWorks.PMIGtolBoxData
    Dim vAnns As Variant, vTypen As Variant, vWerte As Variant
    Dim i As Long, j As Long, k As Long, m As Long
    Dim sText As String

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType = swDocDRAWING Then Exit Sub   ' GetPMIData gilt nicht in Zeichnungen
    vAnns = swModel.Extension.GetAnnotations
    If IsEmpty(vAnns) Then Exit Sub

    For i = 0 To UBound(vAnns)
        Set swAnn = vAnns(i)
        If swAnn.GetPMIType = swPMIType_GTol Then
            Set swToleranz = swAnn.GetPMIData
            If Not swToleranz Is Nothing Then
                Debug.Print swAnn.GetName & ": " & swToleranz.GetText
                For j = 0 To swToleranz.GetFrameCount - 1
                    Set swRahmen = swToleranz.GetFrameAtIndex(j)
                    For k = 0 To swRahmen.GetGtolBoxCount - 1
                        Set swFeld = swRahmen.GetGtolBoxAtIndex(k)
                        sText = "  Rahmen " & j & ", Feld " & k & ": " & swFeld.TolValue
                        If swFeld.Unit = swPMIUnit_MM Then sText = sText & " mm"
                        If swFeld.ToleranceZoneModifier = swToleranceZoneModifier_Diameter Then sText = sText & ", Zone zylindrisch"
                        If swFeld.MaterialModifier = swMaterialModifier_MaximumMaterialCondition Then sText = sText & ", Maximum-Material"
                        Debug.Print sText
                        vTypen = swFeld.GetTolTypes
                        vWerte = swFeld.GetTolTypeValues
                        If IsArray(vTypen) And IsArray(vWerte) Then
                            For m = 0 To UBound(vTypen)
                                Debug.Print "    Art der Toleranzzone " & vTypen(m) & ": " & vWerte(m)
                            Next m
                        End If
                    Next k
                Next j
            End If
        End If
    Next i
End Sub

Bemerkungen

Einheiten: PMIGtolBoxData.Unit liefert die Einheit des Feldes als Wert aus swPMIUnit_e. Dass PMIGtolBoxData.TolValue und die Werte zur Toleranz je Flächeneinheit in dieser Einheit stehen und nicht wie sonst in der API in Metern, sagt die Hilfe nicht ausdrücklich, ist aber zu vermuten.

Toleranz je Flächeneinheit: Die drei Eigenschaften dazu gelten nur, wenn PMIFrameData.GeometricCharacteristic Ebenheit oder Geradheit liefert (swGeometricCharacteristic_Flatness, swGeometricCharacteristic_Straightness aus swGeometricCharacteristic_e). Aus den Maßen berechnest du die Einheitsfläche und teilst den Toleranzwert durch sie.

Zwei Arrays: Die Einträge von PMIGtolBoxData.GetTolTypes und PMIGtolBoxData.GetTolTypeValues mit gleichem Index gehören eins zu eins zusammen.

Nur lesen: Die VBA-Syntax deklariert die Eigenschaften als Property ohne „nur lesbar“. Die .NET-Hilfe gibt sie als nur lesbar an, das Setzen ist nicht umgesetzt.

Hilfebeispiel: Das Beispiel „Get PMI Data“ zu Annotation.GetPMIData gibt die sieben Eigenschaften aus, die drei Methoden nutzt es nicht.

Eigenschaften und Methoden

Eigenschaften 7, davon 7 beschrieben

NameBeschreibung
MaterialModifierLiefert die Materialbedingung des Toleranzwerts in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz.
TolerancePerUnitTypeLiefert die Form der Einheitsfläche bei einer Toleranz je Flächeneinheit in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz.
TolerancePerUnitValue1Liefert das erste Maß der Einheitsfläche bei einer Toleranz je Flächeneinheit in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz.
TolerancePerUnitValue2Liefert das zweite Maß einer rechteckigen Einheitsfläche bei einer Toleranz je Flächeneinheit in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz.
ToleranceZoneModifierLiefert die Form der Toleranzzone in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz, etwa zylindrisch oder kugelförmig.
TolValueLiefert den Toleranzwert in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz.
UnitLiefert die Einheit der Toleranz in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz, etwa Millimeter oder Zoll.

Methoden 3, davon 3 beschrieben

NameBeschreibung
GetAdditionalSymbolsLiefert die Zusatzsymbole in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz, etwa freier Zustand oder Tangentialebene.
GetTolTypesLiefert die Arten der Toleranzzone in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz, etwa projizierte Toleranzzone.
GetTolTypeValuesLiefert die Werte zu den Arten der Toleranzzone in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz.

Siehe auch

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

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