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: Returns 1.
Failure: Returns 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()
    Local $msg

    GUICreate("My GUI") ; start the definition

    GUISetState() ; will display an empty dialog box

    ; Run the GUI until the dialog is closed
    While 1
        $msg = GUIGetMsg()

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