Objekt · SldWorks
PMIGtolBoxData-Objekt
Ein Toleranzfeld im Toleranzrahmen einer Form- und Lagetoleranz aus PMI-Daten: Toleranzwert, Einheit, Materialbedingung, Toleranzzone und Zusatzsymbole.
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
PMIFrameData.GetGtolBoxAtIndex: ein Toleranzfeld eines Rahmens. Die Zahl liefertPMIFrameData.GetGtolBoxCount.
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| MaterialModifier | Liefert die Materialbedingung des Toleranzwerts in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz. |
| TolerancePerUnitType | Liefert die Form der Einheitsfläche bei einer Toleranz je Flächeneinheit in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz. |
| TolerancePerUnitValue1 | Liefert das erste Maß der Einheitsfläche bei einer Toleranz je Flächeneinheit in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz. |
| TolerancePerUnitValue2 | Liefert das zweite Maß einer rechteckigen Einheitsfläche bei einer Toleranz je Flächeneinheit in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz. |
| ToleranceZoneModifier | Liefert die Form der Toleranzzone in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz, etwa zylindrisch oder kugelförmig. |
| TolValue | Liefert den Toleranzwert in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz. |
| Unit | Liefert die Einheit der Toleranz in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz, etwa Millimeter oder Zoll. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| GetAdditionalSymbols | Liefert die Zusatzsymbole in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz, etwa freier Zustand oder Tangentialebene. |
| GetTolTypes | Liefert die Arten der Toleranzzone in diesem Toleranzfeld einer PMI-Form- und Lagetoleranz, etwa projizierte Toleranzzone. |
| GetTolTypeValues | Liefert 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.