SolidWorksMakroprogrammierung

Objekt · SldWorks

PMIGtolData-Objekt

Die PMI-Daten einer Form- und Lagetoleranz aus einem STEP-242-Modell: Toleranzrahmen, Texte, Anzahl, Bezugslinie und Zwischen-Punkte.

Deklaration Dim x As SldWorks.PMIGtolData · in der englischen .NET-Hilfe: IPMIGtolData

Beschreibung

PMIGtolData gibt Zugriff auf die PMI-Daten (Product and Manufacturing Information) einer Form- und Lagetoleranz in einem STEP-242-Modell. Solche Daten übernimmt SOLIDWORKS aus importierten STEP-242-Dateien. Eine Form- und Lagetoleranz besteht aus einem oder mehreren Toleranzrahmen (PMIFrameData). Jeder Rahmen enthält die Toleranzart, Toleranzfelder (PMIGtolBoxData) und Bezugsfelder (PMIGtolFrameDatum). Alle Befehle lesen nur. Die Befehle gibt es seit SOLIDWORKS 2019.

Zugriff

GetPMIData gilt nicht in Zeichnungen und liefert Nothing, wenn zur Beschriftung keine PMI-Daten gehören.

Beispiel

' Gibt für jede Form- und Lagetoleranz aus PMI-Daten Text, Anzahl, Bezugslinie
' und die Toleranzrahmen mit Toleranzart, Toleranzwerten und Bezügen aus.
' Vorbedingung: Ein Teil aus einer STEP-242-Datei mit PMI-Beschriftungen ist offen.
' Ergebnis:     Die Angaben 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 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 & ": " & swToleranz.GetText
                Debug.Print "  Anzahl:            " & swToleranz.InstanceCount
                Debug.Print "  Zusammengesetzt:   " & swToleranz.IsComposite
                Debug.Print "  Text unter Rahmen: " & swToleranz.GetTextBelowFrames
                If swToleranz.LeaderType = swPMILeaderType_NoLeader Then
                    Debug.Print "  Ohne Bezugslinie"
                Else
                    Debug.Print "  Bezugslinie: Stil " & swToleranz.LeaderStyle & ", Seite " & swToleranz.LeaderLocation
                End If
                For j = 0 To swToleranz.GetFrameCount - 1
                    Set swRahmen = swToleranz.GetFrameAtIndex(j)
                    If Not swRahmen Is Nothing Then
                        sZeile = "  Rahmen " & j & ": 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

Gültigkeit: Das Objekt gilt nur, wenn Annotation.GetPMIType swPMIType_GTol liefert. Besteht eine Beschriftung nur aus PMI-Daten, liefert Annotation.GetType swPMIOnly und Annotation.GetSpecificAnnotation Nothing, siehe swAnnotationType_e. Das Hilfebeispiel „Get PMI Data“ fragt dagegen die Art swGTol (Wert 5) ab und prüft dann GetPMIType.

Andere PMI-Daten: Bei Bemaßungen liefert Annotation.GetPMIData ein PMIDimensionData, bei Bezügen ein PMIDatumData.

Gtol: Form- und Lagetoleranzen, die in SOLIDWORKS selbst entstehen, sind Gtol-Objekte mit eigenen Befehlen, etwa aus ModelDoc2.InsertGtol. PMIGtolData beschreibt nur die übernommenen PMI-Daten.

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 nutzt alle Befehle außer GetFirstPoint und GetSecondPoint.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
InstanceCountLiefert, wie oft diese PMI-Form- und Lagetoleranz wiederholt gilt.
LeaderLocationLiefert, auf welcher Seite die Bezugslinie dieser PMI-Form- und Lagetoleranz ansetzt.
LeaderModifierLiefert das Zusatzsymbol an der Bezugslinie dieser PMI-Form- und Lagetoleranz, etwa rundum oder überall.
LeaderStyleLiefert den Stil der Bezugslinie dieser PMI-Form- und Lagetoleranz, etwa gerade, geknickt oder rechtwinklig.
LeaderTypeLiefert, ob diese PMI-Form- und Lagetoleranz keine Bezugslinie, eine einfache oder eine mit mehreren Knicken hat.

Methoden 7, davon 7 beschrieben

NameBeschreibung
GetFirstPointLiefert die Bezeichnung des ersten Punkts bei einer PMI-Form- und Lagetoleranz, die zwischen zwei Punkten oder Elementen gilt.
GetFrameAtIndexLiefert einen Toleranzrahmen dieser PMI-Form- und Lagetoleranz.
GetFrameCountLiefert die Zahl der Toleranzrahmen dieser PMI-Form- und Lagetoleranz.
GetSecondPointLiefert die Bezeichnung des zweiten Punkts bei einer PMI-Form- und Lagetoleranz, die zwischen zwei Punkten oder Elementen gilt.
GetTextLiefert den Text dieser PMI-Form- und Lagetoleranz.
GetTextBelowFramesLiefert den Text unter den Toleranzrahmen dieser PMI-Form- und Lagetoleranz.
IsCompositeLiefert, ob diese PMI-Form- und Lagetoleranz die Symbole zweier Rahmen zusammenfasst.

Siehe auch

Englisches Original: IPMIGtolData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.