Objekt · SldWorks
Frame-Objekt
Das Hauptfenster von SOLIDWORKS: Dokumentfenster, Menüs und Kontextmenüs, Statusleiste, Fensterhandle und Sichtbarkeit.
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
SldWorks.Frame: das Hauptfenster (main frame) von SOLIDWORKS
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| KeepInvisible | Liest oder setzt, ob das Hauptfenster von SOLIDWORKS unsichtbar bleibt, auch wenn du ein Dokument aktivierst. |
| MenuPinned | Liest oder setzt, ob das Hauptmenü von SOLIDWORKS angeheftet ist. |
| ModelWindows | Liefert alle Dokumentfenster im Hauptfenster von SOLIDWORKS. |
Methoden 22, davon 16 beschrieben, 6 veraltet
| Name | Beschreibung |
|---|---|
| AddMenu | Fügt einem Menü von SOLIDWORKS ein Menü hinzu. Nur für Anwendungen als DLL. |
| AddMenuItem | veraltet ersetzt durch Frame.AddMenuItem2 |
| AddMenuItem2 | Fügt einem vorhandenen Menü einen Eintrag mit Bild oder eine Trennlinie hinzu. Nur für C++-Anwendungen als DLL. |
| AddMenuPopupIcon | Fügt einem Kontextmenü ein Symbol hinzu. Nur für C++-Add-ins als DLL. |
| AddMenuPopupIcon2 | veraltet ersetzt durch Frame.AddMenuPopupIcon3 |
| AddMenuPopupIcon3 | Fügt in einem Add-in einem Kontextmenü ein Symbol hinzu, mit Bildern in mehreren Größen. |
| AddMenuPopupItem | veraltet ersetzt durch Frame.AddMenuPopupItem2 |
| AddMenuPopupItem2 | Fügt einem Kontextmenü (Rechtsklick) einen Eintrag oder eine Trennlinie hinzu. Nur für C++-Anwendungen als DLL. |
| GetHWnd | veraltet ersetzt durch Frame.GetHWndx64 |
| GetHWndx64 | Liefert das Windows-Fensterhandle des Hauptfensters (64 Bit). |
| GetMenu | veraltet ersetzt durch Frame.GetMenux64 |
| GetMenuState | veraltet ersetzt durch Frame.AddMenuItem2 |
| GetMenux64 | Liefert das Windows-Menühandle des Hauptfensters (64 Bit). |
| GetModelWindowCount | Liefert die Zahl der Dokumentfenster im Hauptfenster. |
| GetStatusBarPane | Legt ein eigenes Feld rechts in der Statusleiste an und liefert es. |
| GetSubMenuCount | Liefert die Zahl der Untermenüs eines Menüs. |
| GetSubMenus | Liefert die Namen der Untermenüs eines Menüs. |
| RemoveMenu | Entfernt einen Menüeintrag. |
| RemoveMenuPopupIcon | Entfernt ein Symbol aus einem Kontextmenü. Nur für C++. |
| RenameMenu | Benennt einen Menüeintrag um. |
| SetStatusBarText | Zeigt einen Text im Hauptbereich links in der Statusleiste. |
| ShowModelWindow | Holt 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.