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.
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
PMIDimensionData.GetDimensionItemAtIndex: die Einträge einer PMI-Bemaßung, gezählt mitPMIDimensionData.GetDimensionItemCount. Die PMI-Bemaßung selbst liefertAnnotation.GetPMIData, wennAnnotation.GetPMITypeswPMIType_Dimensionliefert. Die Beschriftungen eines Modells liefertModelDocExtension.GetAnnotations.
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| AdditionalSymbol | Liefert das Zusatzsymbol eines Eintrags einer PMI-Bemaßung, als Modifikator der Toleranzzone. |
| CalloutText | Liefert den Beschriftungstext eines Eintrags einer PMI-Bemaßung. |
| InstanceCount | Liefert, wie oft der Eintrag einer PMI-Bemaßung vorkommt, etwa 2 bei „2X“. |
| MaxVariation | Liefert die obere Toleranz eines Eintrags einer PMI-Bemaßung. |
| MinVariation | Liefert die untere Toleranz eines Eintrags einer PMI-Bemaßung. |
| Prefix | Liefert das Präfix eines Eintrags einer PMI-Bemaßung, etwa „2X“. |
| Suffix | Liefert das Suffix eines Eintrags einer PMI-Bemaßung. |
| Symbol | Liefert das Symbol eines Eintrags einer PMI-Bemaßung, etwa Durchmesser oder Radius. |
| TolerancePrecision | Liefert die Genauigkeit der Toleranz eines Eintrags einer PMI-Bemaßung. |
| TolType | Liefert die Art der Toleranz eines Eintrags einer PMI-Bemaßung, etwa keine, zweiseitig oder Grenzmaße. |
| Unit | Liefert die Einheit eines Eintrags einer PMI-Bemaßung, etwa Millimeter, Zoll oder Grad. |
| Value | Liefert den Wert (Hauptwert) eines Eintrags einer PMI-Bemaßung. |
| ValuePrecision | Liefert die Genauigkeit des Werts eines Eintrags einer PMI-Bemaßung. |
Methoden 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| IsReferenceOnly | Liefert, 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.