- 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 tab control
See the tutorial, Creating a Tab control
#remarks_header[Properties:]#
ActivePage | This controls which page will be active by default. |
Align | Design only property, does not generate code, helps with aligning controls while editing. alBottom - control moves to bottom of client area, resizes to width of client area x original height alClient - control occupies the whole of the client area alCustom - not used alLeft - control moves to left edge of client area, resizes to original width x height of client area alNone - no aligning alRight - control moves to right edge of client area, resizes to original width x height of client area alTop - control moves to top of client area, resizes to width of client area x original height |
Color | Background color of control. Choose from the list, or enter your own. Format is 0xnumber where number is 6 hexadecimal digits: 2 for blue, 2 for green and 2 for red |
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> |
Images | ImageList containing icons to show at tops of Pages (optional). ImageList must already exist |
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 |
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:]#
TCS_SCROLLOPPOSITE | Unneeded tabs scroll to the opposite side of the control when a tab is selected |
TCS_BOTTOM | Page labels appear at the bottom of pages |
TCS_FLATBUTTONS | With TCS_BUTTONS, buttons are two-dimensional |
TCS_FORCEICONLEFT | Icon is at left edge of page label, leaving text centered. Requires TCS_FIXEDWIDTH |
TCS_FORCELABELLEFT | Text is at left side of page label, icon next to it. Requires TCS_FIXEDWIDTH. Implies TCS_FORCEICONLEFT |
TCS_HOTTRACK | Page label under cursor is highlighted. Requires TCS_BUTTONS |
TCS_VERTICAL | Page labels appear at side of pages: on right if TCS_BOTTOM else at left |
TCS_TABS | Page labels appear normally |
TCS_BUTTONS | Page labels appear and work like buttons. Page area is usually not used. Control has no border. Do not use with TCS_SCROLLOPPOSITE |
TCS_SINGLELINE | When widths of page labels exceed width of control, show horizontal scroll bar |
TCS_MULTILINE | When widths of page labels exceed width of control, show multiple rows of page titles |
TCS_RIGHTJUSTIFY | Page labels widen to occupy width of control. Requires TCS_MULTILINE |
TCS_FIXEDWIDTH | Page labels are all the same width |
TCS_RAGGEDRIGHT | Width of page labels depends on width of labels |
TCS_FOCUSONBUTTONDOWN | Page receives input focus on button down. Useful with TCS_BUTTONS |
TCS_FOCUSNEVER | Page never receives input focus |
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_VISIBLE | Control is visible |
WS_BORDER | Control has a thin-line border |
WS_CLIPSIBLINGS | If this control overlaps with another, this control shows partially |
#remarks_header[Extra Styles:]#
TCS_EX_FLATSEPARATORS | Shows separators between page labels. Requires TCS_BUTTONS and TCS_FLATBUTTONS |
WS_EX_CLIENTEDGE | Control has border with sunken edge |
WS_EX_STATICEDGE | Control has a three-dimensional border |
#remarks_header[Pages:]#
Each page has its own properties:
Caption | Text displayed at the top of the page |
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> |
ImageIndex | Index of image in the attached html_wikilink('control_ImageList','') control. Default is -1 (none) |
Name | Name of control and of the variable that is assigned its control ID in generated code. If not specified, no variable is generated |
#remarks_header[Remarks:]#
With Hints on | Without Hints on | Hints show |
---|---|---|
Control only | all Pages | Control's Hint on all Pages |
Page 1 | Control, other Pages | Page 1 |
Page n | Control | Page n Hint on Pages 1 to n |
Pages 1 and n | Control and other Pages | Only Pages 1 and n have Hints |
Control and any Page(s) | other Pages | on Page(s) - other Pages don't show Control's Hint |
This behavior is acknowledged in AutoIt; it may be due to a deficiency in Windows.
Koda partly overcomes this behavior. If a Page other than the first one specifies a Hint, Koda generates <color blue>GUICtrlSetTip(-1,“”)</color> for the first page.
Koda is unable to have the Hint for the control show when any of the Pages specify a Hint.
#remarks_header[Related:]#
None