Wenn #PB_Any als '#Gadget' Parameter verwendet wird, dann wird die Nummer des neuen Gadgets als 'Ergebnis' zurückgegeben. #Gadget ist die Nummer, die (später) von der EventGadget() 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 eine der folgenden Konstanten annehmen:
#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.Der #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.
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
