SolidWorksMakroprogrammierung

Eigenschaft · ModelDoc2

Extension-Eigenschaft (ModelDoc2)

Liefert das ModelDocExtension-Objekt des Dokuments, über das viele neuere Befehle laufen, zum Beispiel SaveAs3, SelectByID2 und die Dateieigenschaften.

Syntax

Property Extension As ModelDocExtension    ' nur lesen
Set swExt = swModel.Extension

Wert

Das ModelDocExtension-Objekt dieses Dokuments.

Beispiel

' Schreibt die benutzerdefinierte Eigenschaft "Bearbeiter" in das aktive Dokument.
' Vorbedingung: Ein Teil, eine Baugruppe oder eine Zeichnung ist geöffnet.
' Ergebnis:     Unter Datei > Eigenschaften > Benutzerdefiniert steht "Bearbeiter".
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swExt As SldWorks.ModelDocExtension
    Dim swProps As SldWorks.CustomPropertyManager

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then
        swApp.SendMsgToUser2 "Kein Dokument geöffnet.", swMbWarning, swMbOk
        Exit Sub
    End If

    Set swExt = swModel.Extension
    Set swProps = swExt.CustomPropertyManager("")      ' "" = Eigenschaften der Datei, nicht einer Konfiguration
    swProps.Add3 "Bearbeiter", swCustomInfoText, Environ("USERNAME"), swCustomPropertyReplaceValue

    swModel.SetSaveFlag
    swApp.SendMsgToUser2 "Bearbeiter eingetragen.", swMbInformation, swMbOk
End Sub

Bemerkungen

Seit SOLIDWORKS 2003 landen viele neue Befehle für Dokumente nicht mehr in ModelDoc2, sondern in ModelDocExtension. Beide gehören zum selben Dokument. Viele veraltete Befehle von ModelDoc2 haben ihren Nachfolger dort, zum Beispiel SaveAs → ModelDocExtension.SaveAs3, SelectByID → ModelDocExtension.SelectByID2 und AddCustomInfo3 → ModelDocExtension.CustomPropertyManager.

Für einen einzelnen Aufruf brauchst du keine eigene Variable: swModel.Extension.SaveAs3 … funktioniert genauso. Eine Variable swExt lohnt sich, wenn du mehrere Befehle der Extension nacheinander aufrufst.

Der Weg zurück geht über ModelDocExtension.Document: Er liefert das ModelDoc2 zur Extension.

Siehe auch

In den Videos

In 18 Beiträgen verwendet. Alle in der Lösungssuche →

Verfügbarkeit

SOLIDWORKS 2003

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

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