CheckBoxGadget()

Syntax

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

Parameters

#Gadget Eine Nummer, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe Die Position und die Abmessungen des neuen Gadgets.
Text$ Der neben dem Checkbox-Gadget darzustellende Text.
Flags (optional) Flags zum Verändern des Gadget-Verhaltens. Dies kann eine Kombination (verknüpft mit dem bitweisen '|' OR-Operator) der folgenden Konstanten sein: 
  #PB_CheckBox_Right     : rechtsbündige Darstellung des Textes
  #PB_CheckBox_Center    : zentrierte Darstellung des Textes
  #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.

Return value

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.

Remarks

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.

Example

  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

See Also

GetGadgetState(), SetGadgetState(), OptionGadget()

Supported OS

All

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