SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.MBD3DPdfData · in der englischen .NET-Hilfe: IMBD3DPdfData

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

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 Sub

Bemerkungen

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

NameBeschreibung
AccuracyLiest oder setzt die Genauigkeit der verlustbehafteten Komprimierung beim Veröffentlichen als 3D-PDF.
CompressLossyTessellationLiest oder setzt, ob die Polygone des Modells beim Veröffentlichen als 3D-PDF verlustbehaftet komprimiert werden.
CreateAttachSTEP242Liest oder setzt, ob SOLIDWORKS MBD das Modell zusätzlich als STEP 242 exportiert und die STEP-Datei an das 3D-PDF anhängt.
ExcludeFromAnnotationViewLiest oder setzt, ob Stücklisten im 3D-PDF aus den Beschriftungsansichten ausgeschlossen werden.
FilePathLiest oder setzt Pfad und Namen der PDF-Datei, in die SOLIDWORKS MBD das 3D-PDF speichert.
STEP242EditionLiest oder setzt die Edition von STEP 242, vermutlich für die STEP-Datei, die SOLIDWORKS MBD an das 3D-PDF anhängt.
ThemeNameLiest oder setzt Pfad und Namen der Vorlage (theme), nach der SOLIDWORKS MBD das 3D-PDF aufbaut.
ViewPdfAfterSavingLiest oder setzt, ob das 3D-PDF nach dem Veröffentlichen angezeigt wird.

Methoden 12, davon 12 beschrieben

NameBeschreibung
GetAttachmentsLiefert die Dateien, die SOLIDWORKS MBD beim Veröffentlichen an das 3D-PDF anhängt.
GetBomAreaCountLiefert, wie viele Bereiche für Stücklisten (BOM Table Areas) die Vorlage des 3D-PDFs hat.
GetImportedNotesLiefert die Namen der importierten Notizen in der Vorlage des 3D-PDFs.
GetMoreViewsLiefert die Namen der weiteren Ansichten (benannte Ansichten und 3D-Ansichten) für das 3D-PDF.
GetStandardViewsLiefert die Standardansichten für das 3D-PDF als Werte aus swStandardViews_e.
GetTextAndCustomPropertiesLiefert die Textfelder und die Felder für benutzerdefinierte Eigenschaften in der Vorlage des 3D-PDFs.
SetAttachmentsLegt die Dateien fest, die SOLIDWORKS MBD beim Veröffentlichen an das 3D-PDF anhängt.
SetBomTableOrdnet 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.
SetImportedNoteOrdnet einer importierten Notiz der Vorlage eine Notiz des Modells zu.
SetIndependentViewPortLegt fest, welche Ansicht im unabhängigen Ansichtsfenster (independent viewport) des 3D-PDFs erscheint.
SetMoreViewsLegt fest, welche weiteren Ansichten (benannte Ansichten und 3D-Ansichten) des Modells ins 3D-PDF kommen.
SetStandardViewsLegt 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.