Objekt · SldWorks
PMIGtolFrameDatum-Objekt
Ein Bezugsfeld im Toleranzrahmen einer Form- und Lagetoleranz aus PMI-Daten: Bezugsbuchstabe, Materialbedingung und bis zu zwei verknüpfte Bezüge.
Beschreibung
PMIGtolFrameDatum gibt Zugriff auf ein Bezugsfeld (datum box) einer Form- und Lagetoleranz aus PMI-Daten (Product and Manufacturing Information). Solche Daten übernimmt SOLIDWORKS aus importierten STEP-242-Dateien. Ein Toleranzrahmen hat neben den Toleranzfeldern bis zu drei Bezugsfelder: den primären, den sekundären und den tertiären Bezug. Jedes Bezugsfeld kann zusätzlich bis zu zwei verknüpfte Bezüge (linked datums) tragen. Alle Eigenschaften lassen sich nur lesen. Die Befehle gibt es seit SOLIDWORKS 2019.
Zugriff
PMIFrameData.GetGtolDatumAtIndex: ein Bezugsfeld eines Rahmens. Die Zahl liefertPMIFrameData.GetGtolDatumCount.
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 Bezugsfelder jedes
' Toleranzrahmens mit Materialbedingung und verknüpften Bezügen aus.
' Vorbedingung: Ein Teil aus einer STEP-242-Datei mit PMI-Beschriftungen ist offen.
' Ergebnis: Die Bezüge 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 swBezug As SldWorks.PMIGtolFrameDatum
Dim vAnns As Variant
Dim i As Long, j As Long, k As Long
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.GetGtolDatumCount - 1
Set swBezug = swRahmen.GetGtolDatumAtIndex(k)
Debug.Print " Rahmen " & j & ", Bezug " & k & ": " & swBezug.Datum & _
" (Materialbedingung " & swBezug.DatumModifier & ")"
If swBezug.DatumLinked1 <> "" Then
Debug.Print " verknüpft: " & swBezug.DatumLinked1 & " " & swBezug.DatumLinked2
End If
Next k
Next j
End If
End If
Next i
End SubBemerkungen
Primär, sekundär, tertiär: Das Objekt gibt Zugriff auf den primären, sekundären und tertiären Bezug eines Rahmens. Dass der Index von PMIFrameData.GetGtolDatumAtIndex (0 bis 2) diese Reihenfolge hat, sagt die Hilfe nicht ausdrücklich, es ist aber zu vermuten.
Verknüpfte Bezüge: Im Dialog „Eigenschaften der Form- und Lagetoleranz“ gibst du zu jedem der drei Bezüge bis zu zwei verknüpfte Bezüge mit ihren Materialbedingungen an. Dazu öffnest du die Auswahlliste neben dem Bezugsfeld. PMIGtolFrameDatum.Datum liefert den Bezug selbst, PMIGtolFrameDatum.DatumLinked1 und PMIGtolFrameDatum.DatumLinked2 die verknüpften.
Nur lesen: Die VBA-Syntax deklariert alle 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 alle neun Eigenschaften aus. Form- und Lagetoleranzen, die in SOLIDWORKS selbst entstehen, sind Gtol-Objekte und haben eigene Befehle.
Eigenschaften und Methoden
Eigenschaften 9, davon 9 beschrieben
| Name | Beschreibung |
|---|---|
| Datum | Liefert den Bezug dieses Bezugsfelds im Toleranzrahmen einer PMI-Form- und Lagetoleranz. |
| DatumLinked1 | Liefert den ersten verknüpften Bezug dieses Bezugsfelds einer PMI-Form- und Lagetoleranz. |
| DatumLinked2 | Liefert den zweiten verknüpften Bezug dieses Bezugsfelds einer PMI-Form- und Lagetoleranz. |
| DatumLinkedModifier1 | Liefert die Materialbedingung des ersten verknüpften Bezugs dieses Bezugsfelds einer PMI-Form- und Lagetoleranz. |
| DatumLinkedModifier2 | Liefert die Materialbedingung des zweiten verknüpften Bezugs dieses Bezugsfelds einer PMI-Form- und Lagetoleranz. |
| DatumLinkedModifierValue1 | Liefert den Wert der Materialbedingung des ersten verknüpften Bezugs dieses Bezugsfelds einer PMI-Form- und Lagetoleranz. |
| DatumLinkedModifierValue2 | Liefert den Wert der Materialbedingung des zweiten verknüpften Bezugs dieses Bezugsfelds einer PMI-Form- und Lagetoleranz. |
| DatumModifier | Liefert die Materialbedingung des Bezugs in diesem Bezugsfeld einer PMI-Form- und Lagetoleranz. |
| DatumModifierValue | Liefert den Wert der Materialbedingung des Bezugs in diesem Bezugsfeld einer PMI-Form- und Lagetoleranz. |
Siehe auch
Englisches Original: IPMIGtolFrameDatum in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.