SolidWorksMakroprogrammierung

Objekt · SldWorks

PMIDimensionItem-Objekt

Ein Eintrag einer PMI-Bemaßung aus einer STEP-242-Datei: Wert, Toleranz, Einheit, Symbole, Präfix, Suffix und Anzahl, alles nur zum Lesen.

Deklaration Dim x As SldWorks.PMIDimensionItem · in der englischen .NET-Hilfe: IPMIDimensionItem

Beschreibung

PMIDimensionItem gibt Zugriff auf einen Eintrag einer PMI-Bemaßung. PMI (Product and Manufacturing Information) sind Fertigungsangaben wie Bemaßungen, Bezüge und Form- und Lagetoleranzen, die SOLIDWORKS mit einer STEP-242-Datei übernimmt. Eine PMI-Bemaßung (PMIDimensionData) besteht aus einem oder mehreren solchen Einträgen. Woraus genau ein Eintrag besteht, sagt die Hilfe nicht. Alle Befehle liefern Werte nur zum Lesen. Die Befehle gibt es seit SOLIDWORKS 2019.

Zugriff

Beispiel

' Gibt für jede PMI-Bemaßung des Modells Wert, Einheit und Toleranz ihrer Einträge aus.
' Vorbedingung: Eine 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 swBemDaten As SldWorks.PMIDimensionData
    Dim swEintrag As SldWorks.PMIDimensionItem
    Dim vAnns As Variant
    Dim i As Long, k As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.Extension.GetAnnotationCount = 0 Then Exit Sub
    vAnns = swModel.Extension.GetAnnotations

    For i = 0 To UBound(vAnns)
        Set swAnn = vAnns(i)
        If swAnn.GetPMIType = swPMIType_Dimension Then
            Set swBemDaten = swAnn.GetPMIData
            If Not swBemDaten Is Nothing Then
                Debug.Print swAnn.GetName & ": " & swBemDaten.DimensionText
                For k = 0 To swBemDaten.GetDimensionItemCount - 1
                    Set swEintrag = swBemDaten.GetDimensionItemAtIndex(k)
                    Debug.Print "  Eintrag " & k & ": " & swEintrag.Prefix & swEintrag.Value & swEintrag.Suffix & _
                                " (Einheit " & swEintrag.Unit & ")"        ' Wert aus swPMIUnit_e
                    Select Case swEintrag.TolType
                        Case swTolBILAT, swTolLIMIT, swTolFITWITHTOL, swTolFITTOLONLY
                            Debug.Print "    Toleranz " & swEintrag.MinVariation & " / " & swEintrag.MaxVariation
                        Case swTolSYMMETRIC
                            Debug.Print "    Toleranz +/- " & swEintrag.MaxVariation
                    End Select
                    If swEintrag.IsReferenceOnly Then Debug.Print "    Hilfsmaß"
                Next k
            End If
        End If
    Next i
End Sub

Bemerkungen

Hilfebeispiel: Das Beispiel „Get PMI Data“ zu Annotation.GetPMIData öffnet eine STEP-242-Datei mit PMI-Beschriftungen, geht alle Beschriftungen aus ModelDocExtension.GetAnnotations durch und gibt bei Bemaßungen (swDisplayDimension aus Annotation.GetType) mit PMI-Daten alle Eigenschaften der Einträge aus. Nur PMIDimensionItem.IsReferenceOnly ruft es nicht auf.

Passungen: Die API unterstützt die Angaben zu Passungen noch nicht, also Passungsart sowie Toleranzklasse von Bohrung und Welle. Liefert PMIDimensionItem.TolType swTolFIT, swTolFITTOLONLY oder swTolFITWITHTOL, bekommst du diese Angaben über PMIDimensionItem nicht.

Einheiten: Die Hilfe sagt nicht, in welcher Einheit PMIDimensionItem.Value, PMIDimensionItem.MinVariation und PMIDimensionItem.MaxVariation stehen. Vermutlich gilt die Einheit aus PMIDimensionItem.Unit (swPMIUnit_e) und nicht wie sonst in der API Meter oder Bogenmaß.

Eigenschaften und Methoden

Eigenschaften 13, davon 13 beschrieben

NameBeschreibung
AdditionalSymbolLiefert das Zusatzsymbol eines Eintrags einer PMI-Bemaßung, als Modifikator der Toleranzzone.
CalloutTextLiefert den Beschriftungstext eines Eintrags einer PMI-Bemaßung.
InstanceCountLiefert, wie oft der Eintrag einer PMI-Bemaßung vorkommt, etwa 2 bei „2X“.
MaxVariationLiefert die obere Toleranz eines Eintrags einer PMI-Bemaßung.
MinVariationLiefert die untere Toleranz eines Eintrags einer PMI-Bemaßung.
PrefixLiefert das Präfix eines Eintrags einer PMI-Bemaßung, etwa „2X“.
SuffixLiefert das Suffix eines Eintrags einer PMI-Bemaßung.
SymbolLiefert das Symbol eines Eintrags einer PMI-Bemaßung, etwa Durchmesser oder Radius.
TolerancePrecisionLiefert die Genauigkeit der Toleranz eines Eintrags einer PMI-Bemaßung.
TolTypeLiefert die Art der Toleranz eines Eintrags einer PMI-Bemaßung, etwa keine, zweiseitig oder Grenzmaße.
UnitLiefert die Einheit eines Eintrags einer PMI-Bemaßung, etwa Millimeter, Zoll oder Grad.
ValueLiefert den Wert (Hauptwert) eines Eintrags einer PMI-Bemaßung.
ValuePrecisionLiefert die Genauigkeit des Werts eines Eintrags einer PMI-Bemaßung.

Methoden 1, davon 1 beschrieben

NameBeschreibung
IsReferenceOnlyLiefert, ob der Eintrag einer PMI-Bemaßung nur ein Hilfsmaß ist, das Fertigung und Prüfung nicht bindet.

Siehe auch

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

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