SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.PMIDatumTarget · in der englischen .NET-Hilfe: IPMIDatumTarget

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

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 Sub

Bemerkungen

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

NameBeschreibung
AreaStyleLiefert die Form des Zielbereichs der PMI-Bezugsstelle: Kreuz, Kreis, Rechteck oder keiner.
DiameterLiefert den Durchmesser des Zielbereichs der PMI-Bezugsstelle bei Kreuz oder Kreis.
HeightLiefert die Höhe des rechteckigen Zielbereichs der PMI-Bezugsstelle.
MovableStyleLiefert, ob und wie sich das Bezugsstellensymbol der PMI-Bezugsstelle bewegt: horizontal, drehend oder gar nicht.
SymbolStyleLiefert, wo das Bezugsstellensymbol der PMI-Bezugsstelle die Größe des Zielbereichs zeigt: im Symbol oder außerhalb.
UnitLiefert die Einheit der Maße der PMI-Bezugsstelle, etwa Millimeter oder Zoll.
WidthLiefert die Breite des rechteckigen Zielbereichs der PMI-Bezugsstelle.

Methoden 1, davon 1 beschrieben

NameBeschreibung
GetDatumTargetReferencesLiefert 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.