SolidWorksMakroprogrammierung

Objekt · SldWorks

PropertyManagerPageTab-Objekt

Ein Register auf einer PropertyManager-Seite: Beschriftung, aktivieren, und die Gruppenfelder und Steuerelemente, die zum Register gehören.

Deklaration Dim x As SldWorks.PropertyManagerPageTab · in der englischen .NET-Hilfe: IPropertyManagerPageTab

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

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 Function

Bemerkungen

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

NameBeschreibung
CaptionLiest oder setzt den Text eines Registers auf einer PropertyManager-Seite.

Methoden 4, davon 3 beschrieben, 1 veraltet

NameBeschreibung
ActivateHolt ein Register der PropertyManager-Seite nach vorn.
AddControlveraltet ersetzt durch PropertyManagerPageTab.AddControl2
AddControl2Setzt ein Steuerelement direkt auf ein Register der PropertyManager-Seite, ohne Gruppenfeld.
AddGroupBoxSetzt 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.