Button
 |
TAButton |
Creates a button control on the form.
Properties:
| Caption | Text displayed on the control |
| ContextMenu | Specifies context menu to attach to control. Create the ContextMenu first |
| Cursor | Cursor shape to display when mouse is over this control |
| Enabled | False generates GUICtrlSetState(-1, $GUI_DISABLE) |
| Font | Double-click to the right to open the Font dialog. Click on + to show the Color, Name, Size and Style properties |
| Left,Top | Position of control relative to its parent |
| Width,Height | Size of control in pixels |
| Hint | Text that appears when cursor hovers over control. Generates call to GUICtrlSetTip |
| HotKey | Keystroke that makes this control active |
| Name | Name of control and of the variable that is assigned its control ID in generated code. If not specified, no variable is generated |
| OnClick | Generates (in Message Loop mode) a Case or (in OnEvent mode) a call to GUISetOnEvent and a skeleton event function. Double-click to right to open Events Editor |
| Picture | Specifies an image to display. Double-click to the right to open Picture Editor. AutoIt does not support both picture and text on a button so assigning a Picture hides the Caption. |
| Resizing | Click on + to expand resize modes: DocAuto - resize and reposition according to new window size DocRight - Do not move right side DocLeft - Do not move left side DocTop - Do not move top DocBottom - Do not move bottom DocHCenter - Horizontal center remains fixed DocVCenter - Vertical center remains fixed DocWidth - Width does not change DocHeight - Height does not change |
| TabOrder | Sequence in which controls are selected with the Tab and Shift+Tab keys. For a Form and for each Group, TabOrder starts with 0. You may prefer to use the TabOrder Visual Editor: press Ctrl+T to open it. |
| Visible | If False, generates GUICtrlSetState(-1, $GUI_HIDE) |
Styles:
| BS_PUSHBUTTON | default style of button |
| BS_DEFPUSHBUTTON | Heavy black border. For dialog box, pressing Enter presses default button |
| BS_PUSHBOX | Button without face and frame |
| BS_LEFT | Left-aligns the text, word-wrapping if BS_MULTILINE is checked |
| BS_RIGHT | Center-aligns text, word-wrapping if BS_MULTILINE is checked |
| BS_CENTER | Right-aligns text, word-wrapping if BS_MULTILINE is checked |
| BS_TOP | Places text at top of button |
| BS_BOTTOM | Places text at bottom of button |
| BS_VCENTER | Vertically centers text in button |
| BS_MULTILINE | Wraps text to multiple lines if text doesn't fit on one line |
| BS_NOTIFY | Enables button to send BN_KILLFOCUS and BN_SETFOCUS notification messages to Form |
| BS_FLAT | Button appears two-dimensional |
| WS_TABSTOP | Control can be selected with Tab and Shift+Tab |
| WS_HSCROLL | Control has horizontal scroll bar |
| WS_VSCROLL | Control has vertical scroll bar |
| WS_BORDER | Control has a thin-line border |
| WS_CLIPSIBLINGS | If this control overlaps with another, this control shows partially |
Extra Styles:
| WS_EX_CLIENTEDGE | Control has border with sunken edge |
| WS_EX_STATICEDGE | Control has a three-dimensional border |
Remarks:
For colored buttons you can set neither pictures nor styles. This is limitation of the current Autoit coloring code implementation.
Related:
None
