SolidWorksMakroprogrammierung

Objekt · SldWorks

Frame-Objekt

Das Hauptfenster von SOLIDWORKS: Dokumentfenster, Menüs und Kontextmenüs, Statusleiste, Fensterhandle und Sichtbarkeit.

Deklaration Dim x As SldWorks.Frame · in der englischen .NET-Hilfe: IFrame

Beschreibung

Frame gibt Zugriff auf die Rahmenfenster (frames) von SOLIDWORKS, also das Hauptfenster mit seinen Dokumentfenstern, Menüs und Symbolleisten. Es gibt vier solche Rahmen: den Hauptrahmen und je einen für Teile, Baugruppen und Zeichnungen. Welchen du bekommst, hängt davon ab, welcher gerade aktiv ist. Die Befehle gibt es seit SOLIDWORKS 2001Plus, die jüngsten seit SOLIDWORKS 2016.

Zugriff

Bei Frame.AddMenuItem2 hängt das Frame-Objekt davon ab, welcher Rahmen aktiv ist, wenn du SldWorks.Frame aufrufst. Willst du ein Menü etwa nur für Teile ändern, holst du das Frame-Objekt, während ein Teil aktiv ist, zum Beispiel wenn ein Teil zum ersten Mal geladen oder angelegt wird. Ein Menü, das du so dem Rahmen für Teile hinzugefügt hast, bleibt für die laufende SOLIDWORKS-Sitzung bestehen.

Beispiel

' Gibt die Zahl und die Titel aller Dokumentfenster aus, holt das erste nach vorn
' und schreibt einen Text in die Statusleiste.
' Vorbedingung: Mindestens ein Dokument ist offen.
' Ergebnis:     Die Titel stehen im Direktfenster (Strg+G), der Text steht links
'               in der Statusleiste.
Option Explicit

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

    Set swApp = Application.SldWorks
    Set swFrame = swApp.Frame
    If swFrame Is Nothing Then Exit Sub

    Debug.Print swFrame.GetModelWindowCount & " Dokumentfenster"
    Debug.Print "Menü angeheftet: " & swFrame.MenuPinned
    vFenster = swFrame.ModelWindows
    If Not IsArray(vFenster) Then Exit Sub

    For i = 0 To UBound(vFenster)
        Set swFenster = vFenster(i)
        Debug.Print "  " & swFenster.Title
    Next i

    Set swFenster = vFenster(0)
    swFrame.ShowModelWindow swFenster
    swFrame.SetStatusBarText "Fenster " & swFenster.Title & " ist vorn."
End Sub

Bemerkungen

Hilfebeispiele: „Switch Documents“ öffnet drei Teile, legt nach jedem mit SldWorks.CreateNewWindow ein weiteres Fenster an, geht dann alle Fenster aus Frame.ModelWindows durch, holt jedes mit Frame.ShowModelWindow nach vorn und gibt Handle und Titel aus. „Keep SOLIDWORKS Invisible While Activating Documents“ setzt SldWorks.UserControl und SldWorks.Visible auf False und Frame.KeepInvisible auf True, öffnet eine Baugruppe und ihre Komponenten unsichtbar und speichert sie als PDF. Am Ende setzt es beide wieder zurück.

Menüs nur für Add-ins: Frame.AddMenu, Frame.AddMenuItem2 und Frame.AddMenuPopupItem2 funktionieren nur in Anwendungen, die als DLL umgesetzt sind, nicht als EXE, und die Rückruffunktionen müssen exportiert sein. Frame.AddMenuPopupIcon und Frame.RemoveMenuPopupIcon gibt es nur für C++. Frame.AddMenuPopupIcon3 braucht die Kennung (Cookie) eines Add-ins aus ConnectToSW. Aus einem VBA-Makro sind diese Befehle deshalb vermutlich nicht nutzbar. Die übrigen Menübefehle gibt es auch bei SldWorks, etwa SldWorks.AddMenu, SldWorks.AddMenuItem5 und SldWorks.RemoveMenu.

Menünamen: Menüs gibst du als Text mit den übergeordneten Menüs an, etwa Untermenü@Menü. Den Namen eines Menüs in der eingestellten Sprache liefert SldWorks.GetLocalizedMenuName, Name und übergeordnetes Menü eines Menübefehls liefert SldWorks.GetMenuStrings. Mit GetMenuStrings holst du den Namen für Frame.RenameMenu und Frame.RemoveMenu.

Statusleiste: Frame.SetStatusBarText schreibt in den Hauptbereich links in der Statusleiste. Eigene Felder rechts in der Statusleiste legst du mit Frame.GetStatusBarPane als StatusBarPane an, höchstens fünf.

Fensterhandles: Frame.GetHWndx64 und Frame.GetMenux64 gibt es nur mit früher Bindung und in der 64-Bit-Version von SOLIDWORKS. Die VBA-Hilfe nennt als Typ Unknown, die .NET-Hilfe eine 64-Bit-Ganzzahl. Für eigene Variablen eignet sich in 64-Bit-VBA vermutlich LongPtr oder Variant, das sagt die Hilfe aber nicht.

Dokumentfenster: Ein einzelnes Dokumentfenster ist ein ModelWindow, mit Titel, Dokument und eigenem Handle. Lage, Größe und Zustand des Hauptfensters liest und setzt du über SldWorks.FrameState, SldWorks.FrameLeft, SldWorks.FrameTop, SldWorks.FrameWidth und SldWorks.FrameHeight.

Veraltete Befehle: AddMenuItem und GetMenuState ersetzt Frame.AddMenuItem2, AddMenuPopupItem ersetzt Frame.AddMenuPopupItem2, AddMenuPopupIcon2 ersetzt Frame.AddMenuPopupIcon3, GetHWnd ersetzt Frame.GetHWndx64 und GetMenu ersetzt Frame.GetMenux64.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
KeepInvisibleLiest oder setzt, ob das Hauptfenster von SOLIDWORKS unsichtbar bleibt, auch wenn du ein Dokument aktivierst.
MenuPinnedLiest oder setzt, ob das Hauptmenü von SOLIDWORKS angeheftet ist.
ModelWindowsLiefert alle Dokumentfenster im Hauptfenster von SOLIDWORKS.

Methoden 22, davon 16 beschrieben, 6 veraltet

NameBeschreibung
AddMenuFügt einem Menü von SOLIDWORKS ein Menü hinzu. Nur für Anwendungen als DLL.
AddMenuItemveraltet ersetzt durch Frame.AddMenuItem2
AddMenuItem2Fügt einem vorhandenen Menü einen Eintrag mit Bild oder eine Trennlinie hinzu. Nur für C++-Anwendungen als DLL.
AddMenuPopupIconFügt einem Kontextmenü ein Symbol hinzu. Nur für C++-Add-ins als DLL.
AddMenuPopupIcon2veraltet ersetzt durch Frame.AddMenuPopupIcon3
AddMenuPopupIcon3Fügt in einem Add-in einem Kontextmenü ein Symbol hinzu, mit Bildern in mehreren Größen.
AddMenuPopupItemveraltet ersetzt durch Frame.AddMenuPopupItem2
AddMenuPopupItem2Fügt einem Kontextmenü (Rechtsklick) einen Eintrag oder eine Trennlinie hinzu. Nur für C++-Anwendungen als DLL.
GetHWndveraltet ersetzt durch Frame.GetHWndx64
GetHWndx64Liefert das Windows-Fensterhandle des Hauptfensters (64 Bit).
GetMenuveraltet ersetzt durch Frame.GetMenux64
GetMenuStateveraltet ersetzt durch Frame.AddMenuItem2
GetMenux64Liefert das Windows-Menühandle des Hauptfensters (64 Bit).
GetModelWindowCountLiefert die Zahl der Dokumentfenster im Hauptfenster.
GetStatusBarPaneLegt ein eigenes Feld rechts in der Statusleiste an und liefert es.
GetSubMenuCountLiefert die Zahl der Untermenüs eines Menüs.
GetSubMenusLiefert die Namen der Untermenüs eines Menüs.
RemoveMenuEntfernt einen Menüeintrag.
RemoveMenuPopupIconEntfernt ein Symbol aus einem Kontextmenü. Nur für C++.
RenameMenuBenennt einen Menüeintrag um.
SetStatusBarTextZeigt einen Text im Hauptbereich links in der Statusleiste.
ShowModelWindowHolt ein Dokumentfenster im Hauptfenster nach vorn.

Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IGetModelWindows). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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