SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.PMIGtolFrameDatum · in der englischen .NET-Hilfe: IPMIGtolFrameDatum

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

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 Sub

Bemerkungen

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

NameBeschreibung
DatumLiefert den Bezug dieses Bezugsfelds im Toleranzrahmen einer PMI-Form- und Lagetoleranz.
DatumLinked1Liefert den ersten verknüpften Bezug dieses Bezugsfelds einer PMI-Form- und Lagetoleranz.
DatumLinked2Liefert den zweiten verknüpften Bezug dieses Bezugsfelds einer PMI-Form- und Lagetoleranz.
DatumLinkedModifier1Liefert die Materialbedingung des ersten verknüpften Bezugs dieses Bezugsfelds einer PMI-Form- und Lagetoleranz.
DatumLinkedModifier2Liefert die Materialbedingung des zweiten verknüpften Bezugs dieses Bezugsfelds einer PMI-Form- und Lagetoleranz.
DatumLinkedModifierValue1Liefert den Wert der Materialbedingung des ersten verknüpften Bezugs dieses Bezugsfelds einer PMI-Form- und Lagetoleranz.
DatumLinkedModifierValue2Liefert den Wert der Materialbedingung des zweiten verknüpften Bezugs dieses Bezugsfelds einer PMI-Form- und Lagetoleranz.
DatumModifierLiefert die Materialbedingung des Bezugs in diesem Bezugsfeld einer PMI-Form- und Lagetoleranz.
DatumModifierValueLiefert 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.