CheckBoxGadget()

Syntax

Ergebnis = CheckBoxGadget(#Gadget, x, y, Breite, Höhe, Text$ [, Flags])

Erstellt ein Checkbox-Gadget (Häkchen-Schalter) innerhalb der aktuellen Gadget-Liste.

Wenn #PB_Any als '#Gadget' Parameter verwendet wird, dann wird der Identifier des neuen Gadgets als 'Ergebnis' zurückgegeben. #Gadget ist die Nummer, die (später) von der EventGadgetID() Funktion zurückgegeben wird.

Der 'Text$' ist eine optionale Beschreibung der Checkbox, welche rechts vom Gadget dargestellt wird.

'Flags' sind immer optional und können sich aus einer oder mehreren der folgenden Konstanten (verknüpft mit dem '|' OR-Operator) zusammensetzen:

  #PB_CheckBox_Right  : rechtsbündige Darstellung des Textes
  #PB_CheckBox_Center : zentrierte Darstellung des Textes

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

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

Beispiel:

  If OpenWindow(0,0,0,270,130,#PB_Window_SystemMenu|#PB_Window_ScreenCentered,"CheckBoxGadget") And CreateGadgetList(WindowID(0))
    CheckBoxGadget(0,10, 10,250,20,"CheckBox standard")
    CheckBoxGadget(1,10, 40,250,20,"CheckBox checked") : SetGadgetState(1,1)
    CheckBoxGadget(2,10, 70,250,20,"CheckBox right", #PB_CheckBox_Right)
    CheckBoxGadget(3,10,100,250,20,"CheckBox center", #PB_CheckBox_Center)
    Repeat : Until WaitWindowEvent()=#PB_Event_CloseWindow
  EndIf

Unterstützte OS

All