SolidWorksMakroprogrammierung

Objekt · SldWorks

PropertyManagerPageGroup-Objekt

Ein Gruppenfeld auf einer PropertyManager-Seite: Titel, auf- und zugeklappt, sichtbar, Kontrollkästchen im Titel, Hintergrundfarbe, und die Steuerelemente darin.

Deklaration Dim x As SldWorks.PropertyManagerPageGroup · in der englischen .NET-Hilfe: IPropertyManagerPageGroup

Beschreibung

PropertyManagerPageGroup gibt Zugriff auf ein Gruppenfeld einer PropertyManager-Seite. Ein Gruppenfeld ist ein Abschnitt der Seite mit Titelleiste, den der Benutzer auf- und zuklappen kann. Nach den Regeln von SOLIDWORKS stehen alle Steuerelemente einer Seite in Gruppenfeldern. Du legst das Gruppenfeld mit PropertyManagerPage2.AddGroupBox an und setzt mit PropertyManagerPageGroup.AddControl2 Steuerelemente hinein. Jedes dieser Steuerelemente ist zugleich ein PropertyManagerPageControl, das Gruppenfeld selbst gehört nicht zu diesen Steuerelementen.

Die Befehle gibt es seit SOLIDWORKS 2001Plus, AddControl2 seit 2014 SP01.

Zugriff

Beispiel

' Ausschnitt aus dem Aufbau einer PropertyManager-Seite im Klassenmodul des Handlers.
' Vorbedingung: swSeite ist eine mit SldWorks.CreatePropertyManagerPage angelegte Seite
'               (PropertyManagerPage2), die noch nicht angezeigt wird. Die Klasse
'               implementiert PropertyManagerPage2Handler9, siehe PropertyManagerPage2.
' Ergebnis:     Das Gruppenfeld „Fase“ ist zugeklappt. Hakt der Benutzer es im Titel an,
'               klappt es auf, und das Makro gibt den neuen Zustand aus.
Const ID_FASE As Long = 20
Const ID_FASE_TEXT As Long = 21
Const ID_FASE_WERT As Long = 22

Dim swSeite As SldWorks.PropertyManagerPage2
Dim swGruppe As SldWorks.PropertyManagerPageGroup

Private Sub GruppeAnlegen()
    Dim nOptionen As Long
    Dim swSteuer As SldWorks.PropertyManagerPageControl

    Set swGruppe = swSeite.AddGroupBox(ID_FASE, "Fase", _
                                       swGroupBoxOptions_Visible + swGroupBoxOptions_Checkbox)
    If swGruppe Is Nothing Then Exit Sub

    nOptionen = swControlOptions_Visible + swControlOptions_Enabled
    Set swSteuer = swGruppe.AddControl2(ID_FASE_TEXT, swControlType_Label, "Abstand:", _
                                        swControlAlign_LeftEdge, nOptionen, "")
    Set swSteuer = swGruppe.AddControl2(ID_FASE_WERT, swControlType_Numberbox, "", _
                                        swControlAlign_Indent, nOptionen, "Abstand der Fase")
End Sub

Private Sub PropertyManagerPage2Handler9_OnGroupCheck(ByVal Id As Long, ByVal Checked As Boolean)
    If Id = ID_FASE Then
        Debug.Print "Fase " & IIf(Checked, "an", "aus") & ", aufgeklappt: " & swGruppe.Expanded
    End If
End Sub

Bemerkungen

Grenzen: In ein Gruppenfeld passen höchstens 15 Steuerelemente und auf eine Seite höchstens 20 Gruppenfelder.

Wann was geht: Steuerelemente setzt du hinein, bevor die Seite angezeigt wird oder nachdem sie geschlossen ist. Titel, Zustand und Farbe änderst du über die Eigenschaften. Ob ein Gruppenfeld ein Kontrollkästchen im Titel hat, legst du nur beim Anlegen mit swGroupBoxOptions_Checkbox aus swAddGroupBoxOptions_e fest.

Meldungen an den Handler: Klappt der Benutzer ein Gruppenfeld auf oder zu, ruft SOLIDWORKS OnGroupExpand auf, beim Kontrollkästchen im Titel OnGroupCheck, jeweils mit der ID des Gruppenfelds. Setzt das Makro PropertyManagerPageGroup.Checked selbst, kommt kein OnGroupCheck.

Gruppenfeld als Meldung: Du kannst ein Gruppenfeld mit nur einer Beschriftung wie ein Meldungsfeld aussehen lassen, siehe PropertyManagerPageGroup.BackgroundColor.

PropertyManagerPage2.AddGroupBox legt ein Gruppenfeld auch dann an, wenn seine ID schon vergeben ist. Achte deshalb selbst auf eindeutige IDs.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
BackgroundColorLiest oder setzt die Hintergrundfarbe eines Gruppenfelds auf einer PropertyManager-Seite.
CaptionLiest oder setzt den Titel eines Gruppenfelds auf einer PropertyManager-Seite.
CheckedLiest oder setzt das Kontrollkästchen im Titel eines Gruppenfelds, das das Gruppenfeld auf- und zuklappt.
ExpandedLiest oder setzt, ob ein Gruppenfeld auf einer PropertyManager-Seite aufgeklappt ist.
VisibleLiest oder setzt, ob ein Gruppenfeld auf einer PropertyManager-Seite sichtbar ist.

Methoden 2, davon 1 beschrieben, 1 veraltet

NameBeschreibung
AddControlveraltet ersetzt durch PropertyManagerPageGroup.AddControl2
AddControl2Setzt ein neues Steuerelement in das Gruppenfeld, etwa ein Kontrollkästchen, ein Zahlenfeld oder ein Auswahlfeld.

Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IAddControl). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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