Objekt · SldWorks
PMIFrameData-Objekt
Ein Toleranzrahmen einer Form- und Lagetoleranz aus PMI-Daten: Toleranzart, Toleranzfelder und Bezugsfelder.
Beschreibung
PMIFrameData gibt Zugriff auf einen Rahmen (Gtol frame) einer Form- und Lagetoleranz aus PMI-Daten (Product and Manufacturing Information). Solche Daten übernimmt SOLIDWORKS aus importierten STEP-242-Dateien. Eine Form- und Lagetoleranz hat einen oder mehrere Toleranzrahmen. Jeder Rahmen hat eine Toleranzart, etwa Ebenheit oder Position, dazu Toleranzfelder (PMIGtolBoxData) und Bezugsfelder (PMIGtolFrameDatum). Alle Befehle lesen nur. Die Befehle gibt es seit SOLIDWORKS 2019.
Zugriff
PMIGtolData.GetFrameAtIndex: ein Rahmen einer Form- und Lagetoleranz. Die Zahl liefertPMIGtolData.GetFrameCount.
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.
Beispiel
' Gibt für jede Form- und Lagetoleranz aus PMI-Daten jeden Toleranzrahmen mit
' Toleranzart, Toleranzwerten und Bezügen in einer Zeile aus.
' Vorbedingung: Ein Teil aus einer STEP-242-Datei mit PMI-Beschriftungen ist offen.
' Ergebnis: Die Rahmen stehen im Direktfenster (Strg+G), etwa
' " Rahmen 0: Art 10 | 0,1 | A | B" (10 = Position).
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 swBezug As SldWorks.PMIGtolFrameDatum
Dim vAnns As Variant
Dim i As Long, j As Long, k As Long
Dim sZeile 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
For j = 0 To swToleranz.GetFrameCount - 1
Set swRahmen = swToleranz.GetFrameAtIndex(j)
If Not swRahmen Is Nothing Then
sZeile = " Rahmen " & swRahmen.FrameNumber & ": Art " & swRahmen.GeometricCharacteristic
For k = 0 To swRahmen.GetGtolBoxCount - 1
Set swFeld = swRahmen.GetGtolBoxAtIndex(k)
sZeile = sZeile & " | " & swFeld.TolValue
Next k
For k = 0 To swRahmen.GetGtolDatumCount - 1
Set swBezug = swRahmen.GetGtolDatumAtIndex(k)
sZeile = sZeile & " | " & swBezug.Datum
Next k
Debug.Print sZeile
End If
Next j
End If
End If
Next i
End SubBemerkungen
Mehrere Rahmen: PMIGtolData.IsComposite gibt an, ob eine Form- und Lagetoleranz die Symbole zweier Rahmen zusammenfasst (zusammengesetzter Rahmen). Der Index der Rahmen beginnt bei 0, PMIFrameData.FrameNumber liefert ihn für diesen Rahmen.
Felder: Der Index liegt bei PMIFrameData.GetGtolBoxAtIndex und PMIFrameData.GetGtolDatumAtIndex zwischen 0 und 2. Ein Rahmen hat also bis zu drei Toleranzfelder und bis zu drei Bezugsfelder (primär, sekundär, tertiär).
Nur lesen: Die VBA-Syntax deklariert die beiden 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 nutzt alle sechs Befehle.
Eigenschaften und Methoden
Eigenschaften 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| FrameNumber | Liefert den Index dieses Toleranzrahmens in seiner PMI-Form- und Lagetoleranz. |
| GeometricCharacteristic | Liefert die Toleranzart dieses Toleranzrahmens einer PMI-Form- und Lagetoleranz, etwa Ebenheit, Position oder Rundlauf. |
Methoden 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| GetGtolBoxAtIndex | Liefert ein Toleranzfeld dieses Toleranzrahmens einer PMI-Form- und Lagetoleranz. |
| GetGtolBoxCount | Liefert die Zahl der Toleranzfelder in diesem Toleranzrahmen einer PMI-Form- und Lagetoleranz. |
| GetGtolDatumAtIndex | Liefert ein Bezugsfeld dieses Toleranzrahmens einer PMI-Form- und Lagetoleranz. |
| GetGtolDatumCount | Liefert die Zahl der Bezugsfelder in diesem Toleranzrahmen einer PMI-Form- und Lagetoleranz. |
Siehe auch
Englisches Original: IPMIFrameData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.