Objekt · SldWorks
PMIGtolData-Objekt
Die PMI-Daten einer Form- und Lagetoleranz aus einem STEP-242-Modell: Toleranzrahmen, Texte, Anzahl, Bezugslinie und Zwischen-Punkte.
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
Annotation.GetPMIData: aus einer Beschriftung, wennAnnotation.GetPMITypeswPMIType_GTol(swPMIType_e) liefert. Die Beschriftungen eines Teils liefert etwaModelDocExtension.GetAnnotations.
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| InstanceCount | Liefert, wie oft diese PMI-Form- und Lagetoleranz wiederholt gilt. |
| LeaderLocation | Liefert, auf welcher Seite die Bezugslinie dieser PMI-Form- und Lagetoleranz ansetzt. |
| LeaderModifier | Liefert das Zusatzsymbol an der Bezugslinie dieser PMI-Form- und Lagetoleranz, etwa rundum oder überall. |
| LeaderStyle | Liefert den Stil der Bezugslinie dieser PMI-Form- und Lagetoleranz, etwa gerade, geknickt oder rechtwinklig. |
| LeaderType | Liefert, ob diese PMI-Form- und Lagetoleranz keine Bezugslinie, eine einfache oder eine mit mehreren Knicken hat. |
Methoden 7, davon 7 beschrieben
| Name | Beschreibung |
|---|---|
| GetFirstPoint | Liefert die Bezeichnung des ersten Punkts bei einer PMI-Form- und Lagetoleranz, die zwischen zwei Punkten oder Elementen gilt. |
| GetFrameAtIndex | Liefert einen Toleranzrahmen dieser PMI-Form- und Lagetoleranz. |
| GetFrameCount | Liefert die Zahl der Toleranzrahmen dieser PMI-Form- und Lagetoleranz. |
| GetSecondPoint | Liefert die Bezeichnung des zweiten Punkts bei einer PMI-Form- und Lagetoleranz, die zwischen zwei Punkten oder Elementen gilt. |
| GetText | Liefert den Text dieser PMI-Form- und Lagetoleranz. |
| GetTextBelowFrames | Liefert den Text unter den Toleranzrahmen dieser PMI-Form- und Lagetoleranz. |
| IsComposite | Liefert, 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.