# Function Reference

# GUISetState

Changes the state of a GUI window.

GUISetState ( [flag [, winhandle]] )

## Parameters

flag | [optional] @SW_SHOW = Shows a previously hidden window (default) @SW_HIDE = Hide window @SW_MINIMIZE = Minimize window @SW_MAXIMIZE = Maximize window @SW_RESTORE = Undoes a window minimization @SW_DISABLE = Disables the window @SW_ENABLE = Enables the window @SW_LOCK = Lock the window to avoid repainting. @SW_UNLOCK = Unlock windows to allow painting. @SW_SHOWDEFAULT - Sets the show state based on the SW_ flag specified in the STARTUPINFO structure @SW_SHOWMAXIMIZED - Activates the window and displays it as a maximized window @SW_SHOWMINIMIZED - Activates the window and displays it as a minimized window @SW_SHOWMINNOACTIVE - Displays the window as a minimized window @SW_SHOWNA - Displays the window in its current state @SW_SHOWNOACTIVATE - Displays a window in its most recent size and position @SW_SHOWNORMAL - Activates and displays a window
winhandle | [optional] Windows handle as returned by GUICreate() (default is the previously used window).

## Return Value

Success: | 1.
Failure: | 0.

## Remarks

When windows are created they are initially hidden so you must use this function to display them (@SW_SHOW).
Only one window can be locked with @SW_LOCK. Any other @SW_LOCK will lock the requested window.
@SW_UNLOCK just ignored the "winhandle" to unlock any locked window.

## Related

GUICreate

## Example

    #include <GUIConstantsEx.au3>

    Example()

    Func Example()
        GUICreate("My GUI") ; start the definition

        GUISetState(@SW_SHOW) ; will display an empty dialog box

        ; Loop until the user exits.
        While 1
            Switch GUIGetMsg()
                Case $GUI_EVENT_CLOSE
                    ExitLoop

            EndSwitch
        WEnd
    EndFunc   ;==>Example