- Foreword
- Basics
- Interface
- Menu
- File
- Import
- Edit
- View
- Options
- Options
- Tools
- Help
- Windows & Dialogs
- Controls
- Standard
- Additional
- Win32
-
- Property Editors
- Appendices
{|class=“cboxtable”
class=“cboxcell1” |
class=“cboxcell2” |
Creates a button control on the form.
#remarks_header[Properties:]#
Caption | Text displayed on the control |
ContextMenu | Specifies html_wikilink('control_contextmenu','context menu') to attach to control. html_wikilink('create_menu','Create the ContextMenu') first |
Cursor | Cursor shape to display when mouse is over this control |
Enabled | False generates <color blue>GUICtrlSetState(-1, $GUI_DISABLE)</color> |
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 <color blue>GUICtrlSetTip</color> |
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 <color blue>Case</color> or (in OnEvent mode) a call to <color blue>GUISetOnEvent</color> 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 html_wikilink('proped_images_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 <color blue>GUICtrlSetState(-1, $GUI_HIDE)</color> |
#remarks_header[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 |
#remarks_header[Extra Styles:]#
WS_EX_CLIENTEDGE | Control has border with sunken edge |
WS_EX_STATICEDGE | Control has a three-dimensional border |
#remarks_header[Remarks:]#
For colored buttons you can set neither pictures nor styles. This is limitation of the current Autoit coloring code implementation.
#remarks_header[Related:]#
None