Property

Description

Mobile Support

Font

Color

The color of the control taken from the Application Color repository.

In Windows, the color will only affect the Tab control body. It will not affect the Tab control header. Since version: 2.5a

Note: In Magic xpa 3.0, this property affected the Tab's title color on mobile devices. This was changed and the Tab's title color is now affected by the Title Color property.

Title Color

The foreground and background color of the tab title (header).

If this property is set to 0 (default), the color of the tab titles will be according to the Windows theme.

For any value other than 0, the current tab title will be the same color as the tab (the Tab control's Color property) and the color of all other tab titles will be the color set in this property.

Platform specific:

• On Android and Windows 10 Mobile devices, if the Tab color is a system color or a transparent color, the Tab color will have the same color as the Title Bar Color form property (FG and BG).

• On Android devices, the line under the current tab will have the same color as the color of the tab's text, that is, the tab's FG color.

Since version: 3.1

Android, iOS and Windows 10 Mobile

Hot Track Color

Defines the color for the tab title items when the mouse cursor hovers over them.

This property is enabled only if the Title Color is set. If the Title Color is 0, the color will be according to the Windows theme.

Since version: 3.1

Selected Tab Color

Defines the color of the selected tab page.

This property is enabled only if the Title Color is set. If the Title Color is 0, the color will be according to the Windows theme.

Since version: 3.2

Gradient Style

Specifies the gradient style. Click to open the Gradient Style dialog box and select a gradient style. For a list of the options, click here.

Note: The gradient displayed is from the Foreground value to the Background value of the Gradient Color property. The color displayed for the None style is based on the BG color of the Color property.

This property is available in Rich Client tasks only.

Since version: 1.8

Gradient Color

The color for the gradient background.

Changing the value of the Gradient Style property to solid will disable this property, but will keep its values.

When using gradient, the BG color of the Color property is ignored.

This property is available in Rich Client tasks only.

Since version: 1.8

Help Screen

Specifies whether a Help screen is associated with this control. You can zoom to select a Help screen from the Help list.

For Rich Client controls, only help screens of Type=URL are supported.

For Rich Client controls, the URL can point to a server file and not to a Web location. (Since version: 1.9)

Tooltip

Specifies whether a ToolTip is associated with this control. A number specifies the number of the ToolTip Help in the Help list.

You can enter an expression for a Tooltip so that the Tooltip is dynamic. You can create the expression in Unicode format.

Help Prompt

Specifies whether a Help prompt is associated with this control. You can zoom to select a Help prompt from the Help list.

Visible

Enabled

Tab Control Side

Specifies where the tabs appear for a Tab control: Top, Right, Bottom, or Left. (Right and Left support: Since version: 3.1)

The Right and Left options are not supported by some of the Windows operating systems and may not work properly.

Hot Track

Lets you automatically highlight a tab when the mouse cursor passes over it. The values are True, False (default), or an expression that evaluates to True or False.

When this property is set with an expression, the property will be computed only when opening the form.

If you use XP styles, this property has no effect and will always behave as if the Hot Track property is set to True.

Multiline

Specifies whether the control can contain more than one line of text. The options are:

True – All tabs are displayed at once on more than one line if necessary, as determined by the Tabs Width property.

False – The tabs are displayed as specified in the Tabs Width property. The default value is False.

Tabs Width

You can set this property by selecting from the following options:

Fill To Line – The width of the tabs in each line is set to fill each line. This option is only effective when the tabs are shown in multiline. Otherwise the behavior will be as Fit To Text.

Fit To Text – The width of each tab is determined individually according to the text it displays.

Fixed – The width of all tabs is set according to the width of the longest text defined for a tab.

Fixed In Line – Each tab is evenly spread across the entire width of the Tab control. When this option is selected, the Multiline property is ignored. If there are tabs with large text, the text may be cut in order to fit the width of the Tab control. Since version: 3.1

Image List File Name

Specifies the name of a picture file that serves as a collection of images for display on a Tab control. Recommended image files are 16 pixel, high image graphic files of any length. This property is dependent on the Image List Indexes property. The default value is blank.

Platform specific:

• For Android and iOS devices, the image size is not limited to 16x16. However, the images must be rectangles; so for example, the image list can contain multiple 100x100 images.

• For iOS devices, according to the iOS Human Interface Guidelines, it is best to use an icon whose size is a multiplication of 25 pixels (for example, 25x25 or 50x50).

See also How Do I Associate Images to Different Tabs in a Tab Control?

Android and iOS

Image List Indexes

Lets you specify a comma-delimited numeric string of tokens that represents images stored in the picture file selected for the Image List File Name property. The numeric value of each token is used as an index in the image list. Each icon is set for a tab according to its place in the comma-delimited string, for example, 12 (first tab), 35, (second tab), 23 (third tab), 16 (fourth tab). You can leave an empty space in the string to indicate no image, for example, 1,45, ,5.

The number of tokens in the string do not need to match the number of tabs. If there are more indexes than tabs, Magic xpa ignores the remaining indexes. If there are fewer indexes than tabs, the remaining tabs display no icon.

Android and iOS

Title Padding

Lets you defines the amount of space in pixels around each tab's caption in a Tab control. A value of 0 means that the operating system's default will be used.

Note: When the Tabs Width property is set to Fit To Text or Fill To Line, the right side padding may be bigger than the padding value that you defined. This is handled by the operating system.

Since version: 3.1