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.
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
MBD3DPdfData.GetTextAndCustomProperties: Array der Felder der Vorlage, dasMBD3DPdfDatakommt ausModelDocExtension.GetMBD3DPdfData
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| CustomPropertyName | Liest oder setzt den Namen der benutzerdefinierten Eigenschaft in einem Eigenschaftsfeld der Vorlage eines MBD-3D-PDFs. |
| Description | Liefert die Beschreibung (Anweisung) eines Felds in der Vorlage eines MBD-3D-PDFs. |
| IsCustomProperty | Liefert, ob das Feld der Vorlage ein Eigenschaftsfeld oder ein Textfeld ist. |
| Name | Liefert den Feldnamen eines Felds in der Vorlage eines MBD-3D-PDFs. |
| Value | Liest 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.