Funktionsreferenz

GUICtrlCreateCheckbox

Erstellt eine Checkbox für die GUI.

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

 

Parameter

text Die Beschriftung der Checkbox.
left Die linke Seite des Controls. Wird -1 verwendet, dann wird left mit Hilfe von GUICoordMode berechnet.
top Die Oberkante des Controls. Wird -1 verwendet, dann wird top mit Hilfe von GUICoordMode berechnet.
width [optional] Die Breite des Controls (Standard: Länge des Textes).
height [optional] Die Höhe des Controls (Standard: Höhe des Textes).
style [optional] Legt den Stil des Controls fest. Siehe Anhang GUI-Stile für Controls.

Standard ( -1) : $BS_AUTOCHECKBOX.
Erzwungene Stile : $WS_TABSTOP und $BS_AUTOCHECKBOX, wenn kein Checkbox-Stil angegeben wurde.
exStyle [optional] Legt den erweiterten Stil des Controls fest. Siehe Tabelle der erweiterten Stile.

 

Rückgabewert

Erfolg: Gibt die Identifikationsnummer (Control-ID) des neuen Controls zurück.
Fehler: Gibt 0 zurück.

 

Bemerkungen

Um den Wert des Controls zu erhalten, siehe GUICtrlRead.
Um Informationen im Control zu setzen oder zu verändern, siehe GUICtrlUpdate....

Eine Checkbox-Control kann ein Icon oder Bild anzeigen, wenn der Stil $BS_ICON oder $BS_BITMAP verwendet wurde. Um das Bild festzulegen, ist GUICtrlSetImage zu verwenden.
Um weitere Stile zusätzlich zum Standardstil zu verwenden, ist BitOr($GUI_SS_DEFAULT_CHECKBOX, newstyle,...) zu verwenden.

Um die oben angegebenen Werte verwenden zu können, muss #include <ButtonConstants.au3> in das Skript eingefügt werden.

Als Standard für das Verhalten des Controls (bzgl. Größe und/oder Position) bei Größenänderung der GUI gilt $GUI_DOCKHEIGHT. (Die Höhe wird nicht geändert.)
Mögliche Resizing-Parameter siehe GUICtrlSetResizing.

- - - - - - - - Erklärung der Controls - - - - - - - -

 

Verwandte Funktionen

GUICoordMode (Option), GUICtrlUpdate..., GUIGetMsg

 

Beispiel


#include <GUIConstantsEx.au3>

Opt('MustDeclareVars', 1)

Example()

Func Example()
    Local $checkCN, $msg
    GUICreate("Meine GUI Checkbox") ; Erstellt ein GUI-Fenster welches mittig ausgerichtet wird

    $checkCN = GUICtrlCreateCheckbox("Checkbox 1", 10, 10, 120, 20)

    GUISetState() ; Zeigt eine Dialogbox mit 1 Checkbox an

    ; Die Schleife wiederholt sich, bis der Benutzer eine Beenden-Aktion auslöst
    While 1
        $msg = GUIGetMsg()

        If $msg = $GUI_EVENT_CLOSE Then ExitLoop
    WEnd
EndFunc   ;==>Example