Objekt · SldWorks
PropertyManagerPageTab-Objekt
Ein Register auf einer PropertyManager-Seite: Beschriftung, aktivieren, und die Gruppenfelder und Steuerelemente, die zum Register gehören.
Beschreibung
PropertyManagerPageTab gibt Zugriff auf ein Register einer PropertyManager-Seite. Mit Registern teilst du eine umfangreiche Seite in Abschnitte, zwischen denen der Benutzer oben auf der Seite wechselt. Du legst ein Register mit PropertyManagerPage2.AddTab an und setzt mit PropertyManagerPageTab.AddGroupBox Gruppenfelder und mit PropertyManagerPageTab.AddControl2 Steuerelemente darauf. Klickt der Benutzer ein Register an, ruft SOLIDWORKS OnTabClicked des Handlers mit der ID des Registers auf. Nach PropertyManagerPageControl zählt auch ein Register zu den Steuerelementen, die zugleich ein PropertyManagerPageControl sind.
Die Befehle gibt es seit SOLIDWORKS 2006, Activate seit 2009 SP01 und AddControl2 seit 2014 SP01.
Zugriff
PropertyManagerPage2.AddTab: legt ein Register auf der Seite an
Beispiel
' Ausschnitt aus dem Aufbau einer PropertyManager-Seite im Klassenmodul des Handlers,
' nach dem Hilfebeispiel „Activate PropertyManager Page Tab“.
' Vorbedingung: swSeite ist eine mit SldWorks.CreatePropertyManagerPage angelegte Seite
' (PropertyManagerPage2), die noch nicht angezeigt wird. Die Klasse
' implementiert PropertyManagerPage2Handler9, siehe PropertyManagerPage2.
' Ergebnis: Die Seite hat die Register „Werkstoff“ und „Maße“ mit je einem Gruppenfeld.
' Beim Anzeigen ist „Werkstoff“ vorn. Klicks auf ein Register stehen im
' Direktfenster.
Const ID_REG_WERKSTOFF As Long = 1
Const ID_REG_MASSE As Long = 2
Const ID_GR_WERKSTOFF As Long = 10
Const ID_GR_MASSE As Long = 11
Dim swSeite As SldWorks.PropertyManagerPage2
Dim swRegister1 As SldWorks.PropertyManagerPageTab
Dim swRegister2 As SldWorks.PropertyManagerPageTab
Dim swGruppe As SldWorks.PropertyManagerPageGroup
Private Sub RegisterAnlegen()
Dim nOptionen As Long
nOptionen = swGroupBoxOptions_Visible + swGroupBoxOptions_Expanded
Set swRegister1 = swSeite.AddTab(ID_REG_WERKSTOFF, "Werkstoff", "", 0)
Set swRegister2 = swSeite.AddTab(ID_REG_MASSE, "Maße", "", 0)
If swRegister1 Is Nothing Or swRegister2 Is Nothing Then Exit Sub
swRegister1.Activate ' wie im Hilfebeispiel vor dem Anzeigen
Set swGruppe = swRegister1.AddGroupBox(ID_GR_WERKSTOFF, "Werkstoff", nOptionen)
Set swGruppe = swRegister2.AddGroupBox(ID_GR_MASSE, "Maße", nOptionen)
End Sub
Private Function PropertyManagerPage2Handler9_OnTabClicked(ByVal Id As Long) As Boolean
Debug.Print "Register " & Id & " angeklickt" ' Rückgabe bleibt False wie im Hilfebeispiel
End FunctionBemerkungen
Wer blendet um: Die Hilfe widerspricht sich. Bei PropertyManagerPageTab.AddControl2 steht: Beim Klick auf ein Register blendet SOLIDWORKS die Steuerelemente des Registers ein und alle anderen aus. Nach OnTabClicked sind Register keine Behälter: Das Makro muss in OnTabClicked selbst die Gruppenfelder und Steuerelemente des Registers ein- und die anderen ausblenden. Steuerelemente, die du mit PropertyManagerPage2.AddControl2 direkt auf die Seite setzt, gehören zu keinem Register, die blendest du in jedem Fall selbst um.
Rückgabe von OnTabClicked: Was der Rückgabewert bewirkt, sagt die Hilfe nicht. Das Hilfebeispiel „Create PropertyManager Page“ setzt ihn nicht, er bleibt also False. Das Beispiel oben macht es ebenso.
Wann was geht: Register legst du nur an, bevor die Seite angezeigt wird. Den Text eines Registers kannst du jederzeit ändern.
Eigenschaften und Methoden
Eigenschaften 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| Caption | Liest oder setzt den Text eines Registers auf einer PropertyManager-Seite. |
Methoden 4, davon 3 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| Activate | Holt ein Register der PropertyManager-Seite nach vorn. |
| AddControl | veraltet ersetzt durch PropertyManagerPageTab.AddControl2 |
| AddControl2 | Setzt ein Steuerelement direkt auf ein Register der PropertyManager-Seite, ohne Gruppenfeld. |
| AddGroupBox | Setzt ein neues Gruppenfeld auf ein Register der PropertyManager-Seite. |
Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IAddControl). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IPropertyManagerPageTab in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.