Objekt · SldWorks
SWPropertySheet-Objekt
Ein Dialog von SOLIDWORKS mit Registerkarten, etwa Extras, Optionen, dem ein Programm eigene Registerkarten hinzufügen kann.
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 FunctionBemerkungen
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
| Name | Beschreibung |
|---|---|
| AddActivePage | Fügt dem Dialog eine Registerkarte hinzu und legt ein ActiveX-Steuerelement darauf. |
| AddPage | veraltet ersetzt durch SWPropertySheet.AddPagex64 und SWPropertySheet |
| AddPagex64 | Fügt dem Dialog eine von CPropertyPage abgeleitete Registerkarte hinzu, in 64-Bit-Programmen. |
| GetControl | Liefert das ActiveX-Steuerelement auf einer Registerkarte des Dialogs. |
| RemovePage | Entfernt eine von CPropertyPage abgeleitete Registerkarte aus dem Dialog. |
Ereignisse 5, davon 0 beschrieben
| Name | Beschreibung |
|---|---|
| CreateControlNotify | Noch nicht beschrieben |
| DestroyNotify | Noch nicht beschrieben |
| HelpNotify | Noch nicht beschrieben |
| OnCancelNotify | Noch nicht beschrieben |
| OnOKNotify | Noch 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.