SolidWorksMakroprogrammierung

Objekt · SldWorks

PMIFrameData-Objekt

Ein Toleranzrahmen einer Form- und Lagetoleranz aus PMI-Daten: Toleranzart, Toleranzfelder und Bezugsfelder.

Deklaration Dim x As SldWorks.PMIFrameData · in der englischen .NET-Hilfe: IPMIFrameData

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

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 Sub

Bemerkungen

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

NameBeschreibung
FrameNumberLiefert den Index dieses Toleranzrahmens in seiner PMI-Form- und Lagetoleranz.
GeometricCharacteristicLiefert die Toleranzart dieses Toleranzrahmens einer PMI-Form- und Lagetoleranz, etwa Ebenheit, Position oder Rundlauf.

Methoden 4, davon 4 beschrieben

NameBeschreibung
GetGtolBoxAtIndexLiefert ein Toleranzfeld dieses Toleranzrahmens einer PMI-Form- und Lagetoleranz.
GetGtolBoxCountLiefert die Zahl der Toleranzfelder in diesem Toleranzrahmen einer PMI-Form- und Lagetoleranz.
GetGtolDatumAtIndexLiefert ein Bezugsfeld dieses Toleranzrahmens einer PMI-Form- und Lagetoleranz.
GetGtolDatumCountLiefert 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.