Function Reference

GUICtrlSetState

Changes the state of a control.

GUICtrlSetState ( controlID, state )

Parameters

controlID	The control identifier (controlID) as returned by a GUICtrlCreate... function.
state	See the State table below.

Return Value

Success:	Returns 1.
Failure:	Returns 0.

Remarks

State table

State	Comments
No Change	0
$GUI_UNCHECKED	Radio or Checkbox will be unchecked
$GUI_CHECKED	Radio or Checkbox will be checked
$GUI_INDETERMINATE	Checkbox having the tristate attribute will be greyed
$GUI_AVISTART	Avi control will start playing
$GUI_AVISTOP	Avi control will stop playing
$GUI_AVICLOSE	Avi control will stop playing and release resource
$GUI_ACCEPTFILES	Input or Edit control will accept drag and drop of files
$GUI_SHOW	Control will be visible. On Tabitem control will select the first tab to be displayed
$GUI_HIDE	Control will not be visible
$GUI_ENABLE	Control will be enabled
$GUI_DISABLE	Control will be greyed out
$GUI_FOCUS	Control will be given input focus
$GUI_DEFBUTTON	Control will be set as the default button on the window

State values can be summed up as for example $GUI_DISABLE + $GUI_HIDE sets the control in an disabled and hidden state.

If an AVI control has to be hidden with $GUI_HIDE it should be closed with $GUI_AVICLOSE.

State of a "contextmenu" or "menu" control cannot be changed.

Example

#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