CheckBoxGadget()

Syntax

Ergebnis = CheckBoxGadget(#Gadget, x, y, Breite, Höhe, Text$ [, Flags])
Beschreibung
Erstellt ein Checkbox-Gadget (Häkchen-Schalter) innerhalb der aktuellen Gadget-Liste.

Parameter

#Gadget Gibt eine Nummer an, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe Geben die Position und die Abmessungen des neuen Gadgets an.
Text$ Gibt den neben dem Checkbox-Gadget darzustellenden Text an.
Flags (optional) Gibt optionale Flags an, um das Gadget-Verhalten zu verändern. Diese können eine Kombination (verknüpft mit dem bitweisen '|' OR-Operator) der folgenden Konstanten sein: 
  #PB_CheckBox_Right     : rechtsbündige Darstellung des Textes (nur auf Windows)
  #PB_CheckBox_Center    : zentrierte Darstellung des Textes (nur auf Windows)
  #PB_CheckBox_ThreeState: Erstellt eine Checkbox, die einen dritten "dazwischen" Status haben kann.
Das #PB_CheckBox_ThreeState Flag kann für eine Checkbox verwendet werden, die den Status mehrerer Einträge repräsentiert. Der "Dazwischen" ("inbetween") Status kann dann verwendet werden, um anzuzeigen, dass die Einstellung nicht für alle Einträge die gleiche ist. Durch Anklicken der Checkbox kann der Anwender diesen wieder auf den "An"- oder "Aus"-Status zurückbringen, um dies auf alle Einträge anzuwenden. Daher kann der "Dazwischen"-Status nur durch das Programm mittels SetGadgetState() gesetzt werden, und nicht durch den Anwender durch Anklicken der Checkbox.

Rückgabewert

Gibt bei Erfolg einen Wert ungleich Null zurück, oder Null bei einem Fehler. Wenn #PB_Any als #Gadget Parameter verwendet wurde, dann beinhaltet der Rückgabewert bei Erfolg die automatisch generierte Gadget-Nummer.

Anmerkungen

Zu diesem Gadget kann mittels GadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.

GetGadgetState() kann zum Ermitteln des aktuellen Gadget-Status verwendet werden.
SetGadgetState() kann zum Ändern des Gadget-Status verwendet werden.

Beispiel

  If OpenWindow(0, 0, 0, 270, 160, "CheckBoxGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    CheckBoxGadget(0, 10,  10, 250, 20, "CheckBox standard")
    CheckBoxGadget(1, 10,  40, 250, 20, "CheckBox checked"): SetGadgetState(1, #PB_Checkbox_Checked)
    CheckBoxGadget(2, 10,  70, 250, 20, "CheckBox three state", #PB_CheckBox_ThreeState): SetGadgetState(2, #PB_Checkbox_Inbetween)
    CheckBoxGadget(3, 10, 100, 250, 20, "CheckBox right", #PB_CheckBox_Right)
    CheckBoxGadget(4, 10, 130, 250, 20, "CheckBox center", #PB_CheckBox_Center)
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Siehe auch

GetGadgetState(), SetGadgetState(), OptionGadget()

Unterstützte OS

Alle

<- ChangeListIconGadgetDisplay() - Gadget Inhaltsverzeichnis - ClearGadgetItemList() ->