SolidWorksMakroprogrammierung

Objekt · SldWorks

TextAndCustomProperty-Objekt

Ein Textfeld oder ein Feld für eine benutzerdefinierte Eigenschaft in der Vorlage (theme) eines MBD-3D-PDFs: Name, Beschreibung und Wert.

Deklaration Dim x As SldWorks.TextAndCustomProperty · in der englischen .NET-Hilfe: ITextAndCustomProperty

Beschreibung

TextAndCustomProperty gibt Zugriff auf die Textfelder und die Felder für benutzerdefinierte Eigenschaften in der Vorlage (theme) eines SOLIDWORKS-MBD-3D-PDFs. MBD (Model Based Definition) ist die zeichnungslose Fertigungsdokumentation von SOLIDWORKS. Ein Textfeld bekommt einen Text als Wert, ein Eigenschaftsfeld den Namen einer benutzerdefinierten Eigenschaft. Die Befehle gibt es seit SOLIDWORKS 2016.

Zugriff

Beispiel

' Setzt die Vorlage eines MBD-3D-PDFs, gibt ihre Felder aus, füllt Textfelder mit
' einem Text und erzeugt das PDF.
' Vorbedingung: Ein Teil ist offen, die Vorlage unter sVorlage und der Ordner C:\Temp
'               gibt es. SOLIDWORKS MBD ist lizenziert.
' Ergebnis:     C:\Temp\MBD.pdf, die Felder stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swPdf As SldWorks.MBD3DPdfData
    Dim swFeld As SldWorks.TextAndCustomProperty
    Dim vFelder As Variant
    Dim sVorlage As String
    Dim i As Long

    sVorlage = "C:\Program Files\SolidWorks Corp\SOLIDWORKS\data\themes\template_approvals\theme.xml"
    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub

    Set swPdf = swModel.Extension.GetMBD3DPdfData
    swPdf.FilePath = "C:\Temp\MBD.pdf"
    swPdf.ThemeName = sVorlage

    vFelder = swPdf.GetTextAndCustomProperties
    If Not IsEmpty(vFelder) Then
        For i = 0 To UBound(vFelder)
            Set swFeld = vFelder(i)
            If swFeld.IsCustomProperty Then
                Debug.Print "Eigenschaftsfeld " & swFeld.Name & ": " & swFeld.CustomPropertyName
            Else
                swFeld.Value = "Geprüft"
                Debug.Print "Textfeld " & swFeld.Name & " (" & swFeld.Description & "): " & swFeld.Value
            End If
        Next i
    End If

    Debug.Print "Ergebnis (0 = Erfolg): " & swModel.Extension.PublishTo3DPDF(swPdf)
End Sub

Bemerkungen

Ablauf: Hole mit ModelDocExtension.GetMBD3DPdfData die Daten für das PDF, setze die Vorlage (ThemeName), die Standardansichten und weitere Ansichten. Dann liest und setzt du die Felder der Vorlage über dieses Objekt, setzt den Pfad (FilePath) und erzeugst das PDF mit ModelDocExtension.PublishTo3DPDF.

Vorlage: Die Eigenschaften entsprechen den Gruppen Text Field und Custom Property Field einer Vorlage: Field name, Instructions und Custom property. Der Pfad der Vorlage im Beispiel ist der einer Standardvorlage von SOLIDWORKS 2024 (template_approvals); bei dir kann er anders sein.

Wert eines Textfelds: Das Hilfebeispiel setzt nur CustomPropertyName und gibt Value nur bei Eigenschaftsfeldern aus. Ob ein Textfeld über Value seinen Text bekommt, ließ sich nicht prüfen: Bei den Standardvorlagen von SOLIDWORKS 2024 lieferte GetTextAndCustomProperties nur Eigenschaftsfelder.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
CustomPropertyNameLiest oder setzt den Namen der benutzerdefinierten Eigenschaft in einem Eigenschaftsfeld der Vorlage eines MBD-3D-PDFs.
DescriptionLiefert die Beschreibung (Anweisung) eines Felds in der Vorlage eines MBD-3D-PDFs.
IsCustomPropertyLiefert, ob das Feld der Vorlage ein Eigenschaftsfeld oder ein Textfeld ist.
NameLiefert den Feldnamen eines Felds in der Vorlage eines MBD-3D-PDFs.
ValueLiest oder setzt den Wert eines Felds in der Vorlage eines MBD-3D-PDFs.

Siehe auch

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

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