Objekt · SldWorks
TaskpaneView-Objekt
Eine eigene Registerkarte im Aufgabenbereich von SOLIDWORKS: Steuerelement, Schaltflächen oben in der Registerkarte, Anzeigen, Ausblenden und Entfernen.
Beschreibung
TaskpaneView gibt Zugriff auf eine Registerkarte, die ein Programm dem Aufgabenbereich (Task Pane) hinzugefügt hat. Auf die Registerkarte legst du ein ActiveX-Steuerelement, in einem .NET-Add-in ein .NET-Steuerelement. Oben in der Registerkarte kann es Schaltflächen geben, Standardschaltflächen von SOLIDWORKS oder eigene mit Bildern. Klicks darauf meldet das Ereignis TaskPaneToolbarButtonClicked. Die ersten Befehle gibt es seit SOLIDWORKS 2005, IsActiveTab seit 2024 SP02 und GetTaskpaneViewWndx64 seit 2025 SP02.
Zugriff
SldWorks.CreateTaskpaneView3: legt die Registerkarte an
Beispiel
' Legt im Aufgabenbereich eine Registerkarte mit vier Standardschaltflächen und einem
' ActiveX-Steuerelement an und zeigt sie.
' Vorbedingung: Das ActiveX-Steuerelement unter PROG_ID ist registriert. Ohne Bilder
' nimmt SOLIDWORKS ein Standardbild für die Registerkarte.
' Ergebnis: Eine neue Registerkarte im Aufgabenbereich. Sie bleibt, bis du sie entfernst.
Option Explicit
Private Const PROG_ID As String = "MeinProjekt.MeinSteuerelement"
Dim swAufgabe As SldWorks.TaskpaneView
Sub main()
Dim swApp As SldWorks.SldWorks
Dim vBilder(5) As String
Set swApp = Application.SldWorks
Set swAufgabe = swApp.CreateTaskpaneView3(vBilder, "Meine Werkzeuge")
If swAufgabe Is Nothing Then Exit Sub
swAufgabe.AddStandardButton swTaskPaneBitmapsOptions_Back, "Zurück"
swAufgabe.AddStandardButton swTaskPaneBitmapsOptions_Next, "Weiter"
swAufgabe.AddStandardButton swTaskPaneBitmapsOptions_Ok, "OK"
swAufgabe.AddStandardButton swTaskPaneBitmapsOptions_Close, "Schließen"
swAufgabe.AddControl PROG_ID, ""
swAufgabe.ShowView
End SubBemerkungen
Ereignisse: Die Registerkarte meldet TaskPaneActivateNotify, TaskPaneDeactivateNotify, TaskPaneDestroyNotify und TaskPaneToolbarButtonClicked mit der Nummer der Schaltfläche. Das Hilfebeispiel „Add Buttons to Task Pane“ fängt sie in einem Klassenmodul mit Public WithEvents swTaskPane As SldWorks.TaskpaneView ab. Die Prozeduren schreibt es als Private Function … As Long. Beim Klick auf die Schaltfläche Schließen ruft es TaskpaneView.DeleteView auf.
Leere Bilderliste: Das Beispiel übergibt SldWorks.CreateTaskpaneView3 ein Array mit leeren Texten. Das Hilfebeispiel „Add Buttons to Task Pane“ übergibt dem veralteten CreateTaskpaneView2 einen leeren Text und nennt das „default image“. Ob das bei CreateTaskpaneView3 genauso geht, sagt die Hilfe nicht.
.NET-Add-ins: TaskpaneView.DisplayWindowFromHandlex64 und TaskpaneView.GetTaskpaneViewWndx64 gibt es nur mit früher Bindung und nur im 64-Bit-SOLIDWORKS. Sie ersetzen DisplayWindowFromHandle und GetTaskpaneViewWnd, die das Handle als 32-Bit-Zahl übergeben. Aus VBA nimmst du TaskpaneView.AddControl.
Veraltet: TaskpaneView.AddCustomButton2 ersetzt das veraltete AddCustomButton. Es nimmt Bilder in mehreren Größen für hochauflösende Bildschirme an.
Tastatur: Für Tastenkürzel in ActiveX-Steuerelementen verweist die Hilfe auf das Thema „Keystrokes and Accelerator Keys in ActiveX Modeless Dialogs and PropertyManager Pages“.
Eigenschaften, Methoden und Ereignisse
Methoden 15, davon 12 beschrieben, 3 veraltet
| Name | Beschreibung |
|---|---|
| AddControl | Setzt ein ActiveX-Steuerelement auf die Registerkarte im Aufgabenbereich. |
| AddCustomButton | veraltet ersetzt durch TaskpaneView.AddCustomButton2 |
| AddCustomButton2 | Fügt der Registerkarte im Aufgabenbereich eine eigene Schaltfläche mit Bildern in mehreren Größen hinzu. |
| AddStandardButton | Fügt der Registerkarte im Aufgabenbereich eine Standardschaltfläche von SOLIDWORKS hinzu, etwa OK, Schließen, Weiter oder Zurück. |
| DeleteView | Entfernt die Registerkarte aus dem Aufgabenbereich. |
| DisplayWindowFromHandle | veraltet ersetzt durch TaskpaneView.DisplayWindowFromHandlex64 |
| DisplayWindowFromHandlex64 | Setzt ein .NET-Steuerelement über sein Fensterhandle auf die Registerkarte, im 64-Bit-SOLIDWORKS. |
| GetButtonState | Liefert, ob eine Schaltfläche der Registerkarte freigegeben ist. |
| GetControl | Liefert das Steuerelement auf der Registerkarte im Aufgabenbereich. |
| GetTaskpaneViewWnd | veraltet ersetzt durch TaskpaneView.GetTaskpaneViewWndx64 |
| GetTaskpaneViewWndx64 | Liefert das Fensterhandle der Registerkarte im Aufgabenbereich, im 64-Bit-SOLIDWORKS. |
| HideView | Blendet die Registerkarte im Aufgabenbereich aus. |
| IsActiveTab | Liefert, ob die Registerkarte im Aufgabenbereich gerade aktiv ist. |
| SetButtonState | Gibt eine Schaltfläche der Registerkarte frei oder sperrt sie. |
| ShowView | Aktiviert die Registerkarte im Aufgabenbereich und zeigt sie. |
Ereignisse 4, davon 0 beschrieben
| Name | Beschreibung |
|---|---|
| TaskPaneActivateNotify | Noch nicht beschrieben |
| TaskPaneDeactivateNotify | Noch nicht beschrieben |
| TaskPaneDestroyNotify | Noch nicht beschrieben |
| TaskPaneToolbarButtonClicked | Noch nicht beschrieben |
Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IGetControl). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ITaskpaneView in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.