AutoIt Language Reference (GUICreate)
[ KiXtart VBScript Batch AutoIt HTA PowerShell Windows Command Lines Other Command Line Utilities ]
Available from version 3.1 through the latest release.
Syntax
GUICreate ( "<title>" [, <width> [, <height> [, <left> [, <top> [, <style> [, <exStyle> [, <parent>]]]]]]] )
Parameters
title = title of the dialog box
width = width of the window (optional)
height = height of the window (optional)
left = left side of the dialog box (optional). By default (-1), the window is centered. If defined, top must also be defined.
top = top of the dialog box (optional). Default (-1) is centered
style = defines the style of the window. See AutoIt Help for style reference.
Use -1 for the default style which includes a combination of $WS_MINIMIZEBOX, $WS_CAPTION, $WS_POPUP, $WS_SYSMENU styles.
exStyle = defines the extended style of the window (optional). -1 is the default.
$WS_EX_ACCEPTFILES = allow an edit or input control within the created GUI window to receive filenames via drag and drop. The control must have also the $GUI_ACCEPTFILES state set by GUICtrlSetState.
$WS_EX_APPWINDOW = forces a top-level window onto the taskbar when the window is visible.
$WS_EX_CLIENTEDGE = specifies that a window has a border with a sunken edge.
$WS_EX_CONTEXTHELP = includes a question mark in the title bar of the window. Cannot be used with the WS_MAXIMIZEBOX or WS_MINIMIZEBOX.
$WS_EX_DLGMODALFRAME Creates a window that has a double border; the window can, optionally, be created with a title bar by specifying the WS_CAPTION style in the style parameter.
$WS_EX_OVERLAPPEDWINDOW = combines the WS_EX_CLIENTEDGE and WS_EX_WINDOWEDGE styles.
$WS_EX_STATICEDGE = creates a window with a three-dimensional border style intended to be used for items that do not accept user input.
$WS_EX_TOPMOST = specifies that a window created with this style should be placed above all non-topmost windows and should stay above them, even when the window is deactivated.
$WS_EX_TRANSPARENT = the window appears transparent because the bits of underlying sibling windows have already been painted.
$WS_EX_TOOLWINDOW = creates a tool window; that is, a window intended to be used as a floating toolbar. A tool window has a title bar that is shorter than a normal title bar, and the window title is drawn using a smaller font. A tool window does not appear in the taskbar or in the dialog box that appears when the user presses ALT+TAB. If a tool window has a system menu, its icon is not displayed on the title bar. However, you can display the system menu by typing ALT+SPACE.
$WS_EX_WINDOWEDGE = specifies that a window has a border with a raised edge.
$WS_EX_LAYERED = creates a layered window. Note that this cannot be used for child windows.
parent = handle of another previously created window - this new window then becomes a child of that window (optional)
Description
Creates a GUI window
Return Values
Success = returns a windows handle
Failure = 0 (if the window cannot be created and sets @error to 1)
Remarks
By default the dialog box is non sizable and non maximizable.
To add styles to default style you may use the BitOr function:
BitOr($GUI_SS_DEFAULT_GUI, newstyle,...)
Also see:
GUIGetMsg GUIDelete WinGetHandle
Have a correction, addition or suggestion on this? Please let us know!
Last Edited: 10/5/2005. This page has been viewed 3097 times. Unless otherwise specified, all information is (C) 2004-2007 iTripoli, Inc. All Rights Reserved.
Note: you can view this information right within ASE by right clicking any keyword and selecting "Help..."
iTripoli prides itself on providing top notch customer service
Find answers or open a ticket to ask directly, when opening a ticket we will suggest relavant articles to help you get answers as quickly and accurately as possible. Visit our support center now!