SolidWorksMakroprogrammierung

Objekt · SldWorks

PMIDatumFeature-Objekt

Ein PMI-Bezugshinweis aus einer STEP-242-Datei: Kennbuchstabe, Form des Rahmens, Anker und Knick der Bezugslinie und Text, alles nur zum Lesen.

Deklaration Dim x As SldWorks.PMIDatumFeature · in der englischen .NET-Hilfe: IPMIDatumFeature

Beschreibung

PMIDatumFeature gibt Zugriff auf einen PMI-Bezugshinweis (datum feature). PMI (Product and Manufacturing Information) sind Fertigungsangaben wie Bemaßungen, Bezüge und Form- und Lagetoleranzen, die SOLIDWORKS mit einer STEP-242-Datei übernimmt. Ein Bezugshinweis besteht aus einem Kennbuchstaben in einem quadratischen oder runden Rahmen. Bezugslinie und Text sind freiwillig. Die zweite Art von PMI-Bezügen ist die Bezugsstelle (PMIDatumTarget). Alle Befehle liefern Werte nur zum Lesen. Die Befehle gibt es seit SOLIDWORKS 2019.

Zugriff

Beispiel

' Gibt für jeden PMI-Bezugshinweis des Modells Kennbuchstabe, Rahmen, Anker und Text 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 swHinweis As SldWorks.PMIDatumFeature
    Dim vAnns As Variant
    Dim i 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_DatumFeature Then
                    Set swHinweis = swBezugDaten.GetDatumFeature
                    Debug.Print swAnn.GetName & ": Bezug " & swHinweis.Label
                    If swHinweis.Shape = swPMIDatumShape_Round Then
                        Debug.Print "  Rahmen rund"
                    Else
                        Debug.Print "  Rahmen quadratisch"
                    End If
                    Debug.Print "  Anker:  " & swHinweis.LeaderAnchorStyle     ' Wert aus swPMIDatumAnchorStyle_e
                    Debug.Print "  Knick:  " & swHinweis.LeaderBendLength
                    Debug.Print "  Text:   " & swHinweis.Text
                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 beim Bezugshinweis alle fünf Eigenschaften aus.

Begriffe: Die Hilfe nennt das Objekt „datum feature“. Auf dieser Website heißt es wie bei swPMIDatumType_e Bezugshinweis.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
LabelLiefert den Kennbuchstaben des PMI-Bezugshinweises, etwa „A“.
LeaderAnchorStyleLiefert die Form des Ankers an der Bezugslinie des PMI-Bezugshinweises: gefülltes oder leeres Dreieck, mit oder ohne Schulter.
LeaderBendLengthLiefert die Länge des ungeknickten Stücks der Bezugslinie des PMI-Bezugshinweises.
ShapeLiefert die Form des Rahmens um den Kennbuchstaben des PMI-Bezugshinweises: quadratisch oder rund.
TextLiefert den Text des PMI-Bezugshinweises.

Siehe auch

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

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