SolidWorksMakroprogrammierung

Objekt · SldWorks

PropertyManagerPageCheckbox-Objekt

Ein Kontrollkästchen auf einer PropertyManager-Seite: Beschriftung, Haken und der Zustand mit „unbestimmt“.

Deklaration Dim x As SldWorks.PropertyManagerPageCheckbox · in der englischen .NET-Hilfe: IPropertyManagerPageCheckbox

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

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

NameBeschreibung
CaptionLiest oder setzt die Beschriftung eines Kontrollkästchens auf einer PropertyManager-Seite.
CheckedLiest oder setzt, ob ein Kontrollkästchen auf einer PropertyManager-Seite angehakt ist.
StateLiest 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.