SolidWorksMakroprogrammierung

Methode · ModelDoc2

GetTitle-Methode (ModelDoc2)

Liefert den Titel des Dokuments, wie er in der Titelleiste des Fensters steht.

Syntax

Function GetTitle() As String
sTitel = swModel.GetTitle

Rückgabewert

Der Titel des Dokuments, meist der Dateiname, zum Beispiel Welle.SLDPRT oder Welle. Bei einem neuen, noch nicht gespeicherten Dokument der vorläufige Name wie Teil1.

Beispiel

' Zeigt Titel und Pfad des aktiven Dokuments nebeneinander.
' Vorbedingung: Ein Dokument ist geöffnet.
' Ergebnis:     Meldung mit Titel und Pfad. Bei einem neuen Dokument ist der Pfad leer.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2

    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

    swApp.SendMsgToUser2 "Titel: " & swModel.GetTitle & vbCrLf & _
                         "Pfad:  " & swModel.GetPathName, swMbInformation, swMbOk
End Sub

Bemerkungen

Ob der Titel die Endung enthält, hängt nicht von SOLIDWORKS ab, sondern von der Windows-Einstellung „Dateinamenerweiterungen“ im Explorer. Auf einem Rechner liefert GetTitle Welle.SLDPRT, auf dem nächsten Welle. Für Meldungen an den Benutzer ist der Titel gut geeignet, für Dateinamen nicht.

Brauchst du den Dateinamen sicher, nimm den Pfad von ModelDoc2.GetPathName und schneide ihn zurecht. Ein Beispiel dafür steht dort. Neue Dokumente haben einen Titel, aber noch keinen Pfad.

Siehe auch

In den Videos

Verfügbarkeit

SOLIDWORKS 2001Plus

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

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