# Funktionsreferenz

GUICtrlCreateCheckbox

Erstellt ein Kontrollkästchen (checkbox) für die GUI.

GUICtrlCreateCheckbox ( "text", left, top [, width [, height [, style [, exStyle]]]] )

Parameter

text | Die Beschriftung des Kontrollkästchens.
left | Die linke Seite des Steuerelements. Wird -1 verwendet, dann wird left mit Hilfe von GUICoordMode berechnet.
top | Die Oberkante des Steuerelements. Wird -1 verwendet, dann wird top mit Hilfe von GUICoordMode berechnet.
width | [optional] Die Breite des Steuerelements (voreingestellt ist die zuvor verwendete Breite).
height | [optional] Die Höhe des Steuerelements (voreingestellt ist die zuvor verwendete Höhe).
style | [optional] Legt den Stil des Steuerelements fest. Siehe Appendix "GUI Control"-Stile. Standard ( -1) : Keine. Erzwungene Stile : $WS_TABSTOP, $BS_AUTOCHECKBOX
exStyle | [optional] Legt den erweiterten Stil des Steuerelements fest. Siehe Tabelle der erweiterten Stile.

Bemerkungen

Um den Wert des Steuerelements zu erhalten siehe GUICtrlRead.
Um Informationen im Steuerelement zu setzen oder zu verändern siehe GUICtrlSet....
Ein Kontrollkästchen-Steuerelement kann ein Icon oder Bild anzeigen, wenn du den Stil $BS_ICON or $BS_BITMAP verwendest. Verwende GUICtrlSetImage um das Bild festzulegen, das verwendet werden soll.
Um weitere Stile zusätzlich zum Standardstil zu verwenden benutze BitOr($GUI_SS_DEFAULT_CHECKBOX, newstyle,...).

Siehe auch

GUICoordMode (Option), GUICtrlSet..., GUIGetMsg

Beispiel

#include <GUIConstants.au3>
GUICreate("My GUI Checkbox") ; will create a dialog box that when displayed is centered
$checkCN = GUICtrlCreateCheckbox ("CHECKBOX 1", 10, 10, 120, 20)
GUISetState () ; will display an dialog box with 1 checkbox
; Run the GUI until the dialog is closed
While 1
$msg = GUIGetMsg()
If $msg = $GUI_EVENT_CLOSE Then ExitLoop
Wend