Objekt · SldWorks
PropertyManagerPageCheckbox-Objekt
Ein Kontrollkästchen auf einer PropertyManager-Seite: Beschriftung, Haken und der Zustand mit „unbestimmt“.
Beschreibung
PropertyManagerPageCheckbox gibt Zugriff auf ein Kontrollkästchen auf einer PropertyManager-Seite. Jedes Steuerelement ist zugleich ein PropertyManagerPageControl. Sichtbarkeit, Aktivierung und QuickInfo steuerst du dort, etwa mit PropertyManagerPageControl.Enabled, PropertyManagerPageControl.Visible und PropertyManagerPageControl.Tip. Das Anklicken meldet die Seite über OnCheckboxCheck an ihren Handler. Caption und Checked gibt es seit SOLIDWORKS 2001Plus, State seit SOLIDWORKS 2017.
Zugriff
PropertyManagerPageGroup.AddControl2mitswControlType_CheckboxausswPropertyManagerPageControlType_e: legt ein Kontrollkästchen in einem Gruppenfeld anPropertyManagerPage2.AddControl2undPropertyManagerPageTab.AddControl2: dasselbe auf der Seite oder in einer Registerkarte
Beispiel
' Ausschnitt aus dem Aufbau einer PropertyManager-Seite: legt ein Kontrollkästchen an.
' Vorbedingung: swGruppe ist ein Gruppenfeld (PropertyManagerPageGroup) auf einer Seite,
' die mit SldWorks.CreatePropertyManagerPage angelegt und noch nicht angezeigt ist.
' Die Seite hat einen Handler, der OnCheckboxCheck mit der ID 1 auswertet.
' Ergebnis: Das Kontrollkästchen erscheint nicht angehakt, sobald die Seite angezeigt wird.
Dim swCheck As SldWorks.PropertyManagerPageCheckbox
Dim nOptionen As Long
nOptionen = swControlOptions_Visible + swControlOptions_Enabled
Set swCheck = swGruppe.AddControl2(1, swControlType_Checkbox, "Bohrungen mitnehmen", _
swControlAlign_LeftEdge, nOptionen, "Auch Bohrungen übernehmen")
If swCheck Is Nothing Then
Debug.Print "Kontrollkästchen nicht angelegt"
Else
swCheck.Checked = False
Debug.Print "Zustand: " & swCheck.State ' 0 = Unchecked, 1 = Checked, 2 = Indeterminate
End If
' Später, etwa im Handler OnCheckboxCheck oder bevor die Seite schließt:
If swCheck.Checked Then Debug.Print "Bohrungen werden mitgenommen"Bemerkungen
Werte lesen: Die Steuerelemente halten nur Vorgabewerte, solange die Seite nicht angezeigt wird (Programmierhandbuch, „Using PropertyManagerPage2 and the Related Objects“). Ist die Seite sichtbar, liefern sie die aktuelle Einstellung. Nach dem Schließen kannst du nicht mehr feststellen, was der Benutzer eingestellt hat. Lies PropertyManagerPageCheckbox.Checked deshalb, solange die Seite noch offen ist, etwa im Handler OnCheckboxCheck oder OnClose.
Gemeinsame Befehle: Für Befehle aus PropertyManagerPageControl weist du das Kontrollkästchen einer Variablen dieses Typs zu. Die Hilfebeispiele holen das Steuerelement erst als PropertyManagerPageControl und weisen es dann mit Set der Variablen des speziellen Typs zu.
Unbestimmt: Den dritten Zustand gibt es nur über PropertyManagerPageCheckbox.State. Das Hilfebeispiel „Set Focus on PropertyManager Page Control“ zeigt beide Eigenschaften.
Eigenschaften und Methoden
Eigenschaften 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| Caption | Liest oder setzt die Beschriftung eines Kontrollkästchens auf einer PropertyManager-Seite. |
| Checked | Liest oder setzt, ob ein Kontrollkästchen auf einer PropertyManager-Seite angehakt ist. |
| State | Liest oder setzt den Zustand eines Kontrollkästchens auf einer PropertyManager-Seite: angehakt, nicht angehakt oder unbestimmt. |
Siehe auch
Englisches Original: IPropertyManagerPageCheckbox in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.