Objekt · SldWorks
PMIDatumTarget-Objekt
Eine PMI-Bezugsstelle aus einer STEP-242-Datei: Form und Maße des Zielbereichs, Stil des Bezugsstellensymbols und die Bezugsangaben darin, alles nur zum Lesen.
Beschreibung
PMIDatumTarget gibt Zugriff auf eine PMI-Bezugsstelle (datum target). 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 Bezugsstelle besteht aus einem Bezugsstellensymbol und einem Zielbereich. Die zweite Art von PMI-Bezügen ist der Bezugshinweis (PMIDatumFeature). Alle Befehle liefern Werte nur zum Lesen. Die Befehle gibt es seit SOLIDWORKS 2019.
Zugriff
PMIDatumData.GetDatumTarget: aus den PMI-Daten eines Bezugs, wennPMIDatumData.GetDatumTypeswPMIDatumType_DatumTargetliefert. Die PMI-Daten des Bezugs liefertAnnotation.GetPMIData, wennAnnotation.GetPMITypeswPMIType_Datumliefert.
Beispiel
' Gibt für jede PMI-Bezugsstelle des Modells die Bezugsangaben und den Zielbereich 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 swBezugDaten As SldWorks.PMIDatumData
Dim swZiel As SldWorks.PMIDatumTarget
Dim vAnns As Variant, vBezuege 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_Datum Then
Set swBezugDaten = swAnn.GetPMIData
If Not swBezugDaten Is Nothing Then
If swBezugDaten.GetDatumType = swPMIDatumType_DatumTarget Then
Set swZiel = swBezugDaten.GetDatumTarget
Debug.Print swAnn.GetName & ": Bezugsstelle"
vBezuege = swZiel.GetDatumTargetReferences
If IsArray(vBezuege) Then
For k = 0 To UBound(vBezuege)
Debug.Print " Bezug: " & vBezuege(k)
Next k
End If
Select Case swZiel.AreaStyle
Case swPMIDatumTargetAreaStyle_X, swPMIDatumTargetAreaStyle_Circular
Debug.Print " Durchmesser " & swZiel.Diameter
Case swPMIDatumTargetAreaStyle_Rectangular
Debug.Print " Breite " & swZiel.Width & ", Höhe " & swZiel.Height
Case Else
Debug.Print " Kein Zielbereich mit Maßen"
End Select
Debug.Print " Einheit " & swZiel.Unit ' Wert aus swPMIUnit_e
End If
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 und geht alle Beschriftungen aus ModelDocExtension.GetAnnotations durch. Liefert Annotation.GetType swDatumTag und GetPMIType swPMIType_Datum, holt es die PMI-Daten des Bezugs und gibt bei einer Bezugsstelle AreaStyle, Diameter, Height, MovableStyle, SymbolStyle und Width aus. Unit und GetDatumTargetReferences nutzt es nicht. Ob Bezugsstellen auch unter swDatumTargetSym erscheinen, sagt die Hilfe nicht; das Beispiel oben fragt deshalb nur GetPMIType ab.
Maße und Form: PMIDatumTarget.Diameter gilt nur bei swPMIDatumTargetAreaStyle_X und swPMIDatumTargetAreaStyle_Circular, PMIDatumTarget.Width und PMIDatumTarget.Height nur bei swPMIDatumTargetAreaStyle_Rectangular (swPMIDatumTargetAreaStyle_e). Die Einheit der Maße liefert PMIDatumTarget.Unit.
Eigenschaften und Methoden
Eigenschaften 7, davon 7 beschrieben
| Name | Beschreibung |
|---|---|
| AreaStyle | Liefert die Form des Zielbereichs der PMI-Bezugsstelle: Kreuz, Kreis, Rechteck oder keiner. |
| Diameter | Liefert den Durchmesser des Zielbereichs der PMI-Bezugsstelle bei Kreuz oder Kreis. |
| Height | Liefert die Höhe des rechteckigen Zielbereichs der PMI-Bezugsstelle. |
| MovableStyle | Liefert, ob und wie sich das Bezugsstellensymbol der PMI-Bezugsstelle bewegt: horizontal, drehend oder gar nicht. |
| SymbolStyle | Liefert, wo das Bezugsstellensymbol der PMI-Bezugsstelle die Größe des Zielbereichs zeigt: im Symbol oder außerhalb. |
| Unit | Liefert die Einheit der Maße der PMI-Bezugsstelle, etwa Millimeter oder Zoll. |
| Width | Liefert die Breite des rechteckigen Zielbereichs der PMI-Bezugsstelle. |
Methoden 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| GetDatumTargetReferences | Liefert die Bezugsangaben der PMI-Bezugsstelle, die in der unteren Hälfte des Bezugsstellensymbols stehen. |
Siehe auch
Englisches Original: IPMIDatumTarget in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.