Objekt · SldWorks
PropertyManagerPageActiveX-Objekt
Ein ActiveX-Steuerelement auf einer PropertyManager-Seite: Klasse festlegen, Höhe, und das Steuerelement selbst, sobald die Seite angezeigt wird.
Beschreibung
PropertyManagerPageActiveX gibt Zugriff auf ein ActiveX-Steuerelement auf einer PropertyManager-Seite. So bringst du ein Steuerelement auf die Seite, das SOLIDWORKS nicht selbst anbietet, etwa einen Kalender oder eine Listenansicht. Du legst den Platzhalter mit AddControl2 und swControlType_ActiveX aus swPropertyManagerPageControlType_e an und nennst mit PropertyManagerPageActiveX.SetClass die Klasse des ActiveX-Steuerelements. SOLIDWORKS erstellt das Steuerelement, wenn die Seite angezeigt wird, und meldet das über OnActiveXControlCreated an den Handler. Wie jedes Steuerelement ist es zugleich ein PropertyManagerPageControl.
Die Befehle gibt es seit SOLIDWORKS 2003.
Zugriff
PropertyManagerPage2.AddControl2,PropertyManagerPageGroup.AddControl2oderPropertyManagerPageTab.AddControl2mitswControlType_ActiveX
Beispiel
' Ausschnitt aus dem Aufbau einer PropertyManager-Seite im Klassenmodul des Handlers.
' Vorbedingung: swGruppe ist ein Gruppenfeld (PropertyManagerPageGroup) auf einer Seite,
' die noch nicht angezeigt wird. Die Klasse implementiert
' PropertyManagerPage2Handler9, siehe PropertyManagerPage2. Das ActiveX-
' Steuerelement MSComctlLib.ListViewCtrl ist auf dem Rechner registriert.
' Ergebnis: Die Seite zeigt die Listenansicht. Nach dem Anzeigen steht der Typ des
' Steuerelements im Direktfenster.
Const ID_LISTE As Long = 50
Dim swGruppe As SldWorks.PropertyManagerPageGroup
Dim swActiveX As SldWorks.PropertyManagerPageActiveX
Private Sub ActiveXAnlegen()
Set swActiveX = swGruppe.AddControl2(ID_LISTE, swControlType_ActiveX, "Liste", _
swControlAlign_LeftEdge, _
swControlOptions_Visible + swControlOptions_Enabled, "")
If swActiveX Is Nothing Then Exit Sub
swActiveX.SetClass "MSComctlLib.ListViewCtrl", "" ' ProgID wie im Hilfetext zu SetClass
swActiveX.Height = 80
End Sub
Private Function PropertyManagerPage2Handler9_OnActiveXControlCreated(ByVal Id As Long, ByVal Status As Boolean) As Long
' Hier noch nicht GetControl aufrufen: Die Seite wird noch nicht angezeigt.
If Not Status Then
PropertyManagerPage2Handler9_OnActiveXControlCreated = swHandleActiveXCreationFailure_Cancel
End If
End Function
Private Sub PropertyManagerPage2Handler9_AfterActivation()
Dim oListe As Object
Set oListe = swActiveX.GetControl ' jetzt ist die Seite angezeigt
If Not oListe Is Nothing Then Debug.Print "ActiveX-Steuerelement: " & TypeName(oListe)
End SubBemerkungen
Ablauf: PropertyManagerPageActiveX.SetClass prüft nicht, ob das Erstellen geklappt hat. Stattdessen ruft SOLIDWORKS bei jedem Versuch OnActiveXControlCreated auf. Mit dem Rückgabewert aus swHandleActiveXCreationFailure_e sagst du, was bei einem Fehlschlag geschehen soll. In diesem Moment wird die Seite noch nicht angezeigt, PropertyManagerPageActiveX.GetControl liefert dann noch nichts. Erst wenn die Seite angezeigt wird, holst du das Steuerelement, stellst seine Eigenschaften ein und verbindest bei Bedarf seine Ereignisse.
AfterActivation: Die Liste der Handler-Methoden sagt, dass SOLIDWORKS AfterActivation aufruft, nachdem die Seite aktiviert wurde. Dass GetControl dort schon klappt, sagt die Hilfe nicht ausdrücklich.
Tastatur: Für Tastenkürzel in ActiveX-Steuerelementen verweist die Hilfe auf das Kapitel „Keystrokes and Accelerator Keys to Handle ActiveX Modeless Dialogs and PropertyManager pages“.
Hilfebeispiel: „Create PropertyManager Page“ enthält die Zeilen für ein ActiveX-Steuerelement nur auskommentiert, mit Platzhaltern für Klassen-ID und Lizenzschlüssel.
Eigenschaften und Methoden
Eigenschaften 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| Height | Liest oder setzt die Höhe eines ActiveX-Steuerelements auf einer PropertyManager-Seite in Dialogeinheiten. |
Methoden 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| GetControl | Liefert das ActiveX-Steuerelement selbst, sobald die PropertyManager-Seite angezeigt wird. |
| SetClass | Legt fest, welches ActiveX-Steuerelement SOLIDWORKS auf der PropertyManager-Seite erstellt: ProgID oder Klassen-ID und Lizenzschlüssel. |
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: IPropertyManagerPageActiveX in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.