SolidWorksMakroprogrammierung

Objekt · SldWorks

TaskpaneView-Objekt

Eine eigene Registerkarte im Aufgabenbereich von SOLIDWORKS: Steuerelement, Schaltflächen oben in der Registerkarte, Anzeigen, Ausblenden und Entfernen.

Deklaration Dim x As SldWorks.TaskpaneView · in der englischen .NET-Hilfe: ITaskpaneView

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

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 Sub

Bemerkungen

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

NameBeschreibung
AddControlSetzt ein ActiveX-Steuerelement auf die Registerkarte im Aufgabenbereich.
AddCustomButtonveraltet ersetzt durch TaskpaneView.AddCustomButton2
AddCustomButton2Fügt der Registerkarte im Aufgabenbereich eine eigene Schaltfläche mit Bildern in mehreren Größen hinzu.
AddStandardButtonFügt der Registerkarte im Aufgabenbereich eine Standardschaltfläche von SOLIDWORKS hinzu, etwa OK, Schließen, Weiter oder Zurück.
DeleteViewEntfernt die Registerkarte aus dem Aufgabenbereich.
DisplayWindowFromHandleveraltet ersetzt durch TaskpaneView.DisplayWindowFromHandlex64
DisplayWindowFromHandlex64Setzt ein .NET-Steuerelement über sein Fensterhandle auf die Registerkarte, im 64-Bit-SOLIDWORKS.
GetButtonStateLiefert, ob eine Schaltfläche der Registerkarte freigegeben ist.
GetControlLiefert das Steuerelement auf der Registerkarte im Aufgabenbereich.
GetTaskpaneViewWndveraltet ersetzt durch TaskpaneView.GetTaskpaneViewWndx64
GetTaskpaneViewWndx64Liefert das Fensterhandle der Registerkarte im Aufgabenbereich, im 64-Bit-SOLIDWORKS.
HideViewBlendet die Registerkarte im Aufgabenbereich aus.
IsActiveTabLiefert, ob die Registerkarte im Aufgabenbereich gerade aktiv ist.
SetButtonStateGibt eine Schaltfläche der Registerkarte frei oder sperrt sie.
ShowViewAktiviert die Registerkarte im Aufgabenbereich und zeigt sie.

Ereignisse 4, davon 0 beschrieben

NameBeschreibung
TaskPaneActivateNotifyNoch nicht beschrieben
TaskPaneDeactivateNotifyNoch nicht beschrieben
TaskPaneDestroyNotifyNoch nicht beschrieben
TaskPaneToolbarButtonClickedNoch 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.