Objekt · SldWorks
PropertyManagerPageGroup-Objekt
Ein Gruppenfeld auf einer PropertyManager-Seite: Titel, auf- und zugeklappt, sichtbar, Kontrollkästchen im Titel, Hintergrundfarbe, und die Steuerelemente darin.
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
PropertyManagerPage2.AddGroupBox: legt ein Gruppenfeld auf der Seite anPropertyManagerPageTab.AddGroupBox: legt ein Gruppenfeld auf einem Register anPropertyManagerPageControl.GetGroupBox: das Gruppenfeld, in dem ein Steuerelement steht
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| BackgroundColor | Liest oder setzt die Hintergrundfarbe eines Gruppenfelds auf einer PropertyManager-Seite. |
| Caption | Liest oder setzt den Titel eines Gruppenfelds auf einer PropertyManager-Seite. |
| Checked | Liest oder setzt das Kontrollkästchen im Titel eines Gruppenfelds, das das Gruppenfeld auf- und zuklappt. |
| Expanded | Liest oder setzt, ob ein Gruppenfeld auf einer PropertyManager-Seite aufgeklappt ist. |
| Visible | Liest oder setzt, ob ein Gruppenfeld auf einer PropertyManager-Seite sichtbar ist. |
Methoden 2, davon 1 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| AddControl | veraltet ersetzt durch PropertyManagerPageGroup.AddControl2 |
| AddControl2 | Setzt 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.