SolidWorksMakroprogrammierung

Objekt · SldWorks

SWPropertySheet-Objekt

Ein Dialog von SOLIDWORKS mit Registerkarten, etwa Extras, Optionen, dem ein Programm eigene Registerkarten hinzufügen kann.

Deklaration Dim x As SldWorks.SWPropertySheet · in der englischen .NET-Hilfe: ISWPropertySheet

Beschreibung

SWPropertySheet erlaubt Programmen, bestimmten Dialogen von SOLIDWORKS eigene Registerkarten (property pages) hinzuzufügen. Ein Beispiel ist der Dialog unter Extras, Optionen: ein Grunddialog (property sheet) mit übereinanderliegenden Registerkarten. Welche Dialoge das erlauben, steht in swPropSheetType_e: die Systemoptionen und die Dialoge für Beleuchtung und Lichtquellen. Ein solcher Dialog ist etwas anderes als eine Seite im PropertyManager. Die Befehle gibt es seit SOLIDWORKS 2004 SP04, AddPagex64 seit 2010 SP01.

Zugriff

  • Ereignis SldWorks.PropertySheetCreateNotify: Parameter Sheet, wenn SOLIDWORKS einen Dialog anlegt, der Registerkarten aufnehmen kann. Der Parameter sheetType nennt die Art als Wert aus swPropSheetType_e.

Beispiel

' Hängt sich an die Ereignisse von SOLIDWORKS und fügt jedem Dialog Extras, Optionen
' eine Registerkarte mit einem ActiveX-Steuerelement hinzu.
' Vorbedingung: Ein UserForm "UserForm1" mit diesem Code, im Modul startet main es mit
'               UserForm1.Show vbModeless. Das ActiveX-Steuerelement unter PROG_ID
'               ist registriert.
' Ergebnis:     Solange das UserForm offen ist, hat Extras, Optionen eine Registerkarte mehr.
Option Explicit

Private Const PROG_ID As String = "MeinProjekt.MeinSteuerelement"   ' ProgID oder {CLSID}
Public WithEvents swAppEvents As SldWorks.SldWorks
Dim swApp As SldWorks.SldWorks

Private Sub UserForm_Initialize()
    Set swApp = Application.SldWorks
    Set swAppEvents = swApp
End Sub

Private Function swAppEvents_PropertySheetCreateNotify(ByVal Sheet As Object, ByVal sheetType As Long) As Long
    Dim swDialog As SldWorks.SWPropertySheet
    Dim nSeite As Long

    If sheetType <> swPropSheetToolsOptions Then Exit Function
    Set swDialog = Sheet
    nSeite = swDialog.AddActivePage("Mein Makro", PROG_ID, "")
    Debug.Print "Registerkarte Nummer " & nSeite
End Function

Bemerkungen

Ablauf: SOLIDWORKS meldet über das Ereignis PropertySheetCreateNotify von SldWorks, dass es einen Dialog angelegt hat, der Registerkarten aufnimmt. Darin prüfst du die Art des Dialogs und fügst deine Registerkarte hinzu. So macht es auch das Hilfebeispiel zu AddActivePage, das dafür ein UserForm mit WithEvents nimmt.

Ereignisse: Das Objekt hat eigene Ereignisse: CreateControlNotify mit der Nummer der Registerkarte und dem Steuerelement, OnOKNotify und OnCancelNotify beim Klick auf OK oder Abbrechen, HelpNotify beim Klick auf Hilfe und DestroyNotify, wenn der Dialog abgebaut wird. Dann lebt das Fenster noch, die Seiten aus der API sind aber schon entfernt. In OnOKNotify holst du typischerweise mit SWPropertySheet.GetControl die Eingaben aus deinem Steuerelement.

MFC-Seiten: In C++ ist SWPropertySheet eine OLE-Hülle um die MFC-Klasse CPropertySheet von SOLIDWORKS. Du legst dort eine von CPropertyPage abgeleitete Seite an und übergibst den Zeiger an SWPropertySheet.AddPagex64. Das veraltete AddPage nahm den Zeiger als 32-Bit-Zahl und ist seit dem 64-Bit-SOLIDWORKS unsicher. Wird der Dialog abgebaut, ruft SOLIDWORKS PostNcDestroy deiner Seite auf. Dort löschst du deine Objekte, etwa die Seite selbst. Aus VBA kommen nur AddActivePage und GetControl in Frage.

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 5, davon 4 beschrieben, 1 veraltet

NameBeschreibung
AddActivePageFügt dem Dialog eine Registerkarte hinzu und legt ein ActiveX-Steuerelement darauf.
AddPageveraltet ersetzt durch SWPropertySheet.AddPagex64 und SWPropertySheet
AddPagex64Fügt dem Dialog eine von CPropertyPage abgeleitete Registerkarte hinzu, in 64-Bit-Programmen.
GetControlLiefert das ActiveX-Steuerelement auf einer Registerkarte des Dialogs.
RemovePageEntfernt eine von CPropertyPage abgeleitete Registerkarte aus dem Dialog.

Ereignisse 5, davon 0 beschrieben

NameBeschreibung
CreateControlNotifyNoch nicht beschrieben
DestroyNotifyNoch nicht beschrieben
HelpNotifyNoch nicht beschrieben
OnCancelNotifyNoch nicht beschrieben
OnOKNotifyNoch nicht beschrieben

Siehe auch

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

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