SolidWorksMakroprogrammierung

Objekt · SldWorks

ModelWindow-Objekt

Ein Dokumentfenster im Hauptfenster von SOLIDWORKS: Titel, angezeigtes Dokument, Fensterhandle und Aktivieren.

Deklaration Dim x As SldWorks.ModelWindow · in der englischen .NET-Hilfe: IModelWindow

Beschreibung

ModelWindow gibt Zugriff auf ein Dokumentfenster (model window) von SOLIDWORKS. Das Hauptfenster (Frame) liefert alle seine Dokumentfenster als Array. Über ein ModelWindow holst du ein Fenster nach vorn, liest seinen Titel oder kommst an das Dokument, das es zeigt. Die Befehle gibt es seit SOLIDWORKS 2007, HWndx64 seit SOLIDWORKS 2010 SP04.

Zugriff

Beispiel

' Gibt für jedes Dokumentfenster den Titel und den Pfad des Dokuments aus und aktiviert
' danach das erste Fenster.
' Vorbedingung: Mindestens ein Dokument ist in einem Fenster offen.
' Ergebnis:     Titel und Pfade stehen im Direktfenster (Strg+G), das erste Fenster ist aktiv.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swFrame As SldWorks.Frame
    Dim swFenster As SldWorks.ModelWindow
    Dim swModel As SldWorks.ModelDoc2
    Dim vFenster As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swFrame = swApp.Frame
    vFenster = swFrame.ModelWindows
    If Not IsArray(vFenster) Then Exit Sub

    For i = 0 To UBound(vFenster)
        Set swFenster = vFenster(i)
        Set swModel = swFenster.ModelDoc
        If Not swModel Is Nothing Then
            Debug.Print swFenster.Title & ": " & swModel.GetPathName
        End If
    Next i

    Set swFenster = vFenster(0)
    swFenster.Activate
End Sub

Bemerkungen

Hilfebeispiel: „Switch Documents“ öffnet drei Teile und legt nach jedem mit SldWorks.CreateNewWindow ein weiteres Fenster an. Dann geht es alle Fenster aus Frame.ModelWindows durch: Es baut das Dokument jedes Fensters mit ModelDoc2.EditRebuild3 neu auf, holt das Fenster mit Frame.ShowModelWindow nach vorn und gibt Fensterhandle und Titel aus. Das Fensterhandle liest es noch mit der veralteten Eigenschaft ModelWindow.HWnd. Heute nimmst du ModelWindow.HWndx64.

Fenster und Ansicht: Was im Fenster zu sehen ist, also Blickrichtung, Zoom und Darstellung, steuerst du über die ModelView des Dokuments. Dort setzt du auch Lage, Größe und Zustand des Dokumentfensters, mit ModelView.FrameLeft, ModelView.FrameTop, ModelView.FrameWidth, ModelView.FrameHeight und ModelView.FrameState. Wie ein ModelWindow zu den Ansichten seines Dokuments gehört, sagt die Hilfe nicht.

Zählen: Die Zahl der Dokumentfenster liefert Frame.GetModelWindowCount. Die Hilfe nennt als Zugriff auch Frame.IGetModelWindows, das gibt es aber nur für C++.

Eigenschaften und Methoden

Eigenschaften 4, davon 3 beschrieben, 1 veraltet

NameBeschreibung
HWndveraltet ersetzt durch ModelWindow.HWndx64
HWndx64Liefert das Windows-Fensterhandle des Dokumentfensters (64 Bit).
ModelDocLiefert das Dokument, das im Fenster angezeigt wird.
TitleLiefert den Titel des Dokumentfensters, wie er in seiner Titelleiste steht.

Methoden 1, davon 1 beschrieben

NameBeschreibung
ActivateAktiviert das Dokumentfenster.

Siehe auch

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

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