Objekt · SldWorks
MBD3DPdfData-Objekt
Die Einstellungen zum Veröffentlichen eines Teils oder einer Baugruppe als 3D-PDF mit SOLIDWORKS MBD: Vorlage (theme), Ansichten, Felder und Stücklisten der Vorlage, Anhänge, Komprimierung und Zieldatei.
Beschreibung
MBD3DPdfData gibt Zugriff auf die Angaben zum Veröffentlichen eines 3D-PDFs mit SOLIDWORKS MBD. MBD (Model Based Definition) ist die zeichnungslose Fertigungsdokumentation von SOLIDWORKS. Das Objekt entspricht dem PropertyManager „Publish to 3D PDF“ von SOLIDWORKS MBD. Du holst es mit ModelDocExtension.GetMBD3DPdfData, stellst es ein und übergibst es an ModelDocExtension.PublishTo3DPDF, das das PDF erzeugt. Die meisten Befehle gibt es seit SOLIDWORKS 2016, die für Anhänge und Komprimierung seit 2017, die für importierte Notizen seit 2018 und STEP242Edition seit 2025 SP03.
Zugriff
ModelDocExtension.GetMBD3DPdfData: die Einstellungen für das Teil oder die Baugruppe
Beispiel
' Lädt SOLIDWORKS MBD und veröffentlicht das aktive Teil oder die aktive Baugruppe
' als 3D-PDF mit Vorderansicht, Draufsicht, dimetrischer Ansicht und allen
' 3D-Ansichten. Eine STEP-242-Datei wird angehängt. Aus Welle.SLDPRT wird Welle.pdf.
' Vorbedingung: Ein Teil oder eine Baugruppe ist offen und wurde schon gespeichert.
' SOLIDWORKS MBD ist lizenziert. Die Vorlagen der Hilfebeispiele
' liegen im Ordner sOrdner, sonst passt du die Pfade an.
' Ergebnis: Das 3D-PDF neben dem Modell, die Felder der Vorlage und das
' Ergebnis im Direktfenster (Strg+G).
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 nAnsichten(2) As Long
Dim v3DAnsichten As Variant
Dim vFelder As Variant
Dim sOrdner As String
Dim nStatus As Long
Dim i As Long
sOrdner = "C:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\data\themes\"
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocPART And swModel.GetType <> swDocASSEMBLY Then Exit Sub
If swModel.GetPathName = "" Then Exit Sub
nStatus = swApp.LoadAddIn("MBD") ' Ergebnis nur ausgeben, siehe Bemerkungen
Debug.Print "LoadAddIn(""MBD""): " & nStatus & " (swLoadAddinError_e)"
Set swPdf = swModel.Extension.GetMBD3DPdfData
If swPdf Is Nothing Then Exit Sub
If swModel.GetType = swDocPART Then
swPdf.ThemeName = sOrdner & "template_approvals\theme.xml"
Else
swPdf.ThemeName = sOrdner & "template_bom_specifications\theme.xml"
End If
swPdf.FilePath = Left(swModel.GetPathName, InStrRev(swModel.GetPathName, ".") - 1) & ".pdf"
swPdf.ViewPdfAfterSaving = False
nAnsichten(0) = swFrontView
nAnsichten(1) = swTopView
nAnsichten(2) = swDimetricView
swPdf.SetStandardViews nAnsichten
v3DAnsichten = swModel.Extension.Get3DViewNames
If Not IsEmpty(v3DAnsichten) Then swPdf.SetMoreViews v3DAnsichten
vFelder = swPdf.GetTextAndCustomProperties
If Not IsEmpty(vFelder) Then
For i = 0 To UBound(vFelder)
Set swFeld = vFelder(i)
Debug.Print "Feld " & swFeld.Name & ": " & swFeld.Description
Next i
End If
swPdf.CreateAttachSTEP242 = True
' Ab SOLIDWORKS 2025 SP03 wählst du auch die Edition:
' swPdf.STEP242Edition = swPublishSTEP242Edition_3_0
nStatus = swModel.Extension.PublishTo3DPDF(swPdf)
If nStatus = swPublishTo3DPDF_Success Then
Debug.Print "Veröffentlicht: " & swPdf.FilePath
Else
Debug.Print "Fehler " & nStatus & " (Wert aus swPublishTo3DPDFError_e)"
End If
End SubBemerkungen
Ablauf: Hole das Objekt mit ModelDocExtension.GetMBD3DPdfData und setze die Vorlage mit MBD3DPdfData.ThemeName. Dann liest und setzt du die Standardansichten und die weiteren Ansichten, füllst die Felder der Vorlage über die Objekte aus MBD3DPdfData.GetTextAndCustomProperties (TextAndCustomProperty), setzt den Pfad mit MBD3DPdfData.FilePath und erzeugst das PDF mit ModelDocExtension.PublishTo3DPDF.
Add-in: Das Objekt und alle seine Befehle brauchen das geladene Add-in SOLIDWORKS MBD. Laden kannst du es mit swApp.LoadAddIn("MBD") (SldWorks.LoadAddIn), über seinen Pfad geht es nicht. In SOLIDWORKS 2024 lieferte LoadAddIn("MBD") 3, und GetMBD3DPdfData und PublishTo3DPDF funktionierten trotzdem. Brich deshalb nicht allein wegen dieses Ergebnisses ab.
Vorlage zuerst: Felder, importierte Notizen, Bereiche für Stücklisten und das unabhängige Ansichtsfenster kommen aus der Vorlage. Vor MBD3DPdfData.GetImportedNotes muss die Vorlage gesetzt sein. Die Hilfebeispiele setzen sie auch vor allen anderen Befehlen, die etwas aus der Vorlage lesen.
Vorlagen: In den Hilfebeispielen ist eine Vorlage eine Datei theme.xml in einem eigenen Ordner unter ...\SOLIDWORKS\data\themes, etwa „simple part (a4, portrait)“ für ein Teil und „simple assembly (a4, landscape)“ für eine Baugruppe. In SOLIDWORKS 2024 gibt es diese Ordner nicht; mitgeliefert sind dort etwa „template_approvals“ und „template_bom_specifications“. Das Beispiel oben nimmt diese. Eigene Vorlagen legt das Hilfebeispiel „Set Independent Viewport for MBD 3D PDF“ mit dem „3D PDF Template Editor“ aus der MBD-Symbolleiste an.
Ergebnis: ModelDocExtension.PublishTo3DPDF liefert einen Wert aus swPublishTo3DPDFError_e, swPublishTo3DPDF_Success (0) heißt Erfolg. Das Hilfebeispiel „Fire Notification When Publishing Part to MBD 3D PDF“ zeigt, dass beim Veröffentlichen eines Teils mit PublishTo3DPDF das Ereignis PublishTo3DPDFNotify des Teils kommt, mit dem Pfad des PDFs. Für Baugruppen gibt es dasselbe Ereignis als AssemblyDoc.PublishTo3DPDFNotify.
Vorgaben: Welche Werte ein frisch geholtes MBD3DPdfData hat, sagt die Hilfe nicht. Setz deshalb alle Werte, auf die es dir ankommt.
3D-PDF über SaveAs3: Ein 3D-PDF ohne Vorlage und ohne diese Einstellungen speichert auch ModelDocExtension.SaveAs3 mit ExportPdfData.ExportAs3D.
Eigenschaften und Methoden
Eigenschaften 8, davon 8 beschrieben
| Name | Beschreibung |
|---|---|
| Accuracy | Liest oder setzt die Genauigkeit der verlustbehafteten Komprimierung beim Veröffentlichen als 3D-PDF. |
| CompressLossyTessellation | Liest oder setzt, ob die Polygone des Modells beim Veröffentlichen als 3D-PDF verlustbehaftet komprimiert werden. |
| CreateAttachSTEP242 | Liest oder setzt, ob SOLIDWORKS MBD das Modell zusätzlich als STEP 242 exportiert und die STEP-Datei an das 3D-PDF anhängt. |
| ExcludeFromAnnotationView | Liest oder setzt, ob Stücklisten im 3D-PDF aus den Beschriftungsansichten ausgeschlossen werden. |
| FilePath | Liest oder setzt Pfad und Namen der PDF-Datei, in die SOLIDWORKS MBD das 3D-PDF speichert. |
| STEP242Edition | Liest oder setzt die Edition von STEP 242, vermutlich für die STEP-Datei, die SOLIDWORKS MBD an das 3D-PDF anhängt. |
| ThemeName | Liest oder setzt Pfad und Namen der Vorlage (theme), nach der SOLIDWORKS MBD das 3D-PDF aufbaut. |
| ViewPdfAfterSaving | Liest oder setzt, ob das 3D-PDF nach dem Veröffentlichen angezeigt wird. |
Methoden 12, davon 12 beschrieben
| Name | Beschreibung |
|---|---|
| GetAttachments | Liefert die Dateien, die SOLIDWORKS MBD beim Veröffentlichen an das 3D-PDF anhängt. |
| GetBomAreaCount | Liefert, wie viele Bereiche für Stücklisten (BOM Table Areas) die Vorlage des 3D-PDFs hat. |
| GetImportedNotes | Liefert die Namen der importierten Notizen in der Vorlage des 3D-PDFs. |
| GetMoreViews | Liefert die Namen der weiteren Ansichten (benannte Ansichten und 3D-Ansichten) für das 3D-PDF. |
| GetStandardViews | Liefert die Standardansichten für das 3D-PDF als Werte aus swStandardViews_e. |
| GetTextAndCustomProperties | Liefert die Textfelder und die Felder für benutzerdefinierte Eigenschaften in der Vorlage des 3D-PDFs. |
| SetAttachments | Legt die Dateien fest, die SOLIDWORKS MBD beim Veröffentlichen an das 3D-PDF anhängt. |
| SetBomTable | Ordnet einem Bereich für Stücklisten in der Vorlage eine Stückliste des Modells zu und legt fest, welche ihrer Spalten ins 3D-PDF kommen. |
| SetImportedNote | Ordnet einer importierten Notiz der Vorlage eine Notiz des Modells zu. |
| SetIndependentViewPort | Legt fest, welche Ansicht im unabhängigen Ansichtsfenster (independent viewport) des 3D-PDFs erscheint. |
| SetMoreViews | Legt fest, welche weiteren Ansichten (benannte Ansichten und 3D-Ansichten) des Modells ins 3D-PDF kommen. |
| SetStandardViews | Legt fest, welche Standardansichten des Modells ins 3D-PDF kommen. |
Siehe auch
Englisches Original: IMBD3DPdfData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.