Tab
 |
TATab |
Creates a tab control
See the tutorial, Creating a Tab control
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 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 |
| 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 Case or (in OnEvent mode) a call to GUISetOnEvent 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 GUICtrlSetState(-1, $GUI_HIDE) |
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 |
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 |
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 GUICtrlSetTip |
| ImageIndex | Index of image in the attached 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:
- AutoIt limits the number of Tab controls on a form to one.
- Microsoft admits that Hints can behave strangely: consider a Tab control with n pages:
| 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 GUICtrlSetTip(-1,””) for the first page.
Koda is unable to have the Hint for the control show when any of the Pages specify a Hint.
Related:
None
