System Projects Reference > The Library Controls Include Project > Use the Library Controls > Tab Library Control | Library Control Include Project | Projects
Tabs Library Control

Tabs genie has the following parameters:

Note: All fields are mandatory unless specified otherwise.

Parameter

Description

Tabs Name

Name of tabs control (max characters). Used to identify the genie when on a graphics page.

Width

Pixel width of the tabs control at runtime.

Note: Leave the size of the genie at design time as 100 pixels, as it will be automatically calculated at runtime.

Tab height

Pixel height of the tabs control at runtime.

Vertical Padding

The vertical distance (in pixels) between the tab elements and the bottom of the tabs control.

Tab Padding

The horizontal distance (in pixels) between the edges and elements of a tab

Tab Min Width

The minimum width allowed for a tab

Tab Max Width

The maximum width allowed for a tab

Auto Width

True/False drop down box. False is selected by default. Determines whether the column width will be automatically adjusted to show full cell content when the control is redrawn.

Icon Add Padding

Additional vertical padding for the display of icon relative to the text. Positive padding will move the icon further upward, and vice versa.

Refresh Rate

The minimum (quickest possible) rate that the control will be redrawn.

The control is only redrawn as required upon changes to the layout, scrolling or other user initiated events.

Scan Delay (Optional)

The number of page scan delay before the genie is initialized at runtime. this can be set to different number on different control genies to stagger the initialization order. If not set defaults to 1

Default Font

The pre-configured font for tab text.

Selection Font

The pre-configured font for a tab when it is selected.

Tab Line Style

The display style of the separator between tabs, options are:
Dark
Light
None

Tab Select Style

The display style for highlighting of selected tab:
Dark
Light
None

Allow Drag Sort

Indicates whether to allow individual tabs to be repositioned by drag and drop.

Allow Drag Delete

Indicates whether to allow individual tabs to be deleted by dragging it vertically away from the tabs control.

Tab Select Icon

The icon to be displayed when a tab is selected. An icon needs to be pre-configured as a symbol in your project. It is specified by the syntax of <symbol library>.<symbol>.

Intialize (Optional)

Callback function that is called when the control initializes The callback function should return either TRUE (1) for success or FALSE (0) if unsuccessful. By default, if the user specified function does not initialize, the control genie will retry the function a few time before giving up. This callback only supports the #Name keyword which represents the name assigned to the control genie.

Note:The initialization callback function may be called multiple times whenever the tab is re-initialized.

Left Mouse (Optional)

Callback function that is called when the user clicks the left mouse button No particular return value is expected from this function, and it supports the following keywords in its argument list:

#Tab= tab ordinal number of the cell that is clicked

#Name = name assigned to the genie

#Ref = reference (assigned when tab is added) of the cell that is clicked

#TabDsp = tab number of the cell relative to the display that is clicked

#Icon =Icon number indicating the different areas within a tab when clicked:
<=0 - text on tab is clicked
1- icon to left hand side of text is clicked
2- icon to right hand side of text is clicked
3- selection icon (only shows up when a tab selected) is clicked

Right Mouse (Optional)

Callback function that is called when the user clicks the right mouse button. It uses the same specification as that of the Left mouse callback.

Double Click (Optional)

Callback function that is called when the user double-click the left mouse button. It uses the same specification as that of the Left mouse callback.

Tabs Reload (Optional)

Callback function that is called when the control is redrawn. No particular return value is expected from this function, and it supports the following keywords in its argument list:

#Name = name assigned to the genie

See Also

Published June 2018