SolidWorksMakroprogrammierung

Methode · SWPropertySheet

AddActivePage-Methode (SWPropertySheet)

Fügt dem Dialog eine Registerkarte hinzu und legt ein ActiveX-Steuerelement darauf.

Syntax

Function AddActivePage( _
   ByVal Title As String, _
   ByVal ProgId As String, _
   ByVal LicenseKey As String _
) As Long
nSeite = swDialog.AddActivePage("Mein Makro", "MeinProjekt.MeinSteuerelement", "")

Parameter

TitleStringByVal
Der Titel der Registerkarte.
ProgIdStringByVal
Das ActiveX-Steuerelement: sein Name, seine ProgID oder seine CLSID (siehe Bemerkungen).
LicenseKeyStringByVal
Der Lizenzschlüssel des Steuerelements, ohne Schlüssel vermutlich "".

Rückgabewert

Die Nummer der neuen Registerkarte im Dialog.

Beispiel

' Im Ereignis PropertySheetCreateNotify von SldWorks (WithEvents swAppEvents).
Private Function swAppEvents_PropertySheetCreateNotify(ByVal Sheet As Object, ByVal sheetType As Long) As Long
    Dim swDialog As SldWorks.SWPropertySheet
    If sheetType = swPropSheetToolsOptions Then
        Set swDialog = Sheet
        nSeite = swDialog.AddActivePage("Mein Makro", "MeinProjekt.MeinSteuerelement", "")
    End If
End Function

Bemerkungen

Du rufst die Methode typischerweise im Ereignis PropertySheetCreateNotify von SldWorks auf. ProgId nimmt den OLE-Kurznamen oder die ProgID der Klasse, etwa "MSCAL.Calendar", so wie das Steuerelement registriert ist. Oder du gibst die CLSID als Text in geschweiften Klammern an, etwa "{9DBAFCCF-592F-101B-85CE-00608CEC297B}". Das Hilfebeispiel übergibt für ProgId und LicenseKey leere Texte. Was dann auf der Registerkarte erscheint, sagt die Hilfe nicht.

Die Nummer brauchst du später: SWPropertySheet.GetControl erwartet sie, und beim Ereignis HelpNotify erkennt dein Programm daran, ob die Hilfe zu deiner Registerkarte gefragt ist. Im Beispiel ist nSeite eine Variable auf Modulebene.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2004 SP04

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

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