# Funktionsreferenz

GUICtrlSetState

Verändert den Status eines Steuerelements.

GUICtrlSetState ( controlID, state )

Parameter

controlID | Die Identifikationsnummer des Steuerelements (Control-ID), wie von einer GUICtrlCreate... Funktion zurückgegeben.
state | Siehe die Status-Tabelle unten.

Bemerkungen

Status-Tabelle

Status | Kommentar
No Change | 0
$GUI_UNCHECKED | Markierung in Radio oder Checkbox wird entfernt
$GUI_CHECKED | Radio oder Checkbox wird markiert
$GUI_INDETERMINATE | Eine Checkbox mit Dreifach-Status-Attibut wird grau dargestellt
$GUI_AVISTART | Avi-Control beginnt mit dem Abspielen des avi-Videos
$GUI_AVISTOP | Avi-Control stoppt das avi-Video
$GUI_AVICLOSE | Avi-Control stoppt das Abspielen und gibt die Videodatei frei
$GUI_ACCEPTFILES | Input- oder Edit-Control akzeptiert das drag & drop-Verfahren für Dateien
$GUI_SHOW | Das Steuerelement wird sichtbar. Auf ein TabItem-Control angewendet, wird die vorderste Registerkarte angezeigt
$GUI_HIDE | Das Steuerelement wird unsichtbar
$GUI_ENABLE | Das Steuerelement kann benutzt werden
$GUI_DISABLE | Das Steuerelement wird grau dargestellt, kann nicht benutzt werden
$GUI_FOCUS | Das Steuerelement erhält den Eingabefocus
$GUI_DEFBUTTON | Das Steuerelement wird zum default-Button des Fensters

Statuswerte können aufsummiert werden; zum Beispiel wird durch $GUI_DISABLE + $GUI_HIDE das Steuerelement deaktiviert und versteckt.
Wenn ein AVI-Control mit $GUI_HIDE versteckt werden soll, sollte es mit $GUI_AVICLOSE geschlossen werden.
Der Status eines Kontextmenüs oder Menüs kann nicht verändert werden.

Siehe auch

ColorMode (Option), GUICtrlCreate..., GUICtrlSetData

Beispiel

#include <GUIConstants.au3>
GUICreate("My GUI state") ; will create a dialog box that when displayed is centered
GUICtrlCreateLabel ("my disable label", 10,20)
GUICtrlSetState(-1,$GUI_DISABLE) ; the label is in disable state
GUICtrlCreateButton ("my button", 50,50)
GUICtrlSetState(-1,$GUI_FOCUS) ; the focus is on this button
GUISetState ()
; Run the GUI until the dialog is closed
While 1
$msg = GUIGetMsg()
If $msg = $GUI_EVENT_CLOSE Then ExitLoop
Wend