Skip to content

XUITabBarStyle

Description

Stores styling properties for a XUITabBar.

The appearance of a XUITabBar is determined by two things - the tab bar's renderer (which is responsible for how the tab bar is drawn) and the tab bar's style. It's style (represented by this class) specifies the colours the renderer should use for certain parts of the tab bar. Of course it is up to the renderer to decide if it should honour these colours but all of the renderers provided with XUI do.

The logic behind separating the renderering of a tab bar from its styling is to facilitate scenarios such as wanting to have a tab bar that looks like the macOS Safari tab bar but has colours more in keeping with Windows or your own branding, for example.

Properties

Name Type Read-Only
BackgroundColor ColorGroup
DisabledTabBackgroundColor ColorGroup
DisabledTabTextColor ColorGroup
FontName String
FontSize Integer
HoverTabBackgroundColor ColorGroup
HoverTabCloseColor ColorGroup
HoverTabTextColor ColorGroup
InactiveTabBackgroundColor ColorGroup
InactiveTabTextColor ColorGroup
MenuButtonBackgroundColor ColorGroup
MenuButtonBorderColor ColorGroup
MenuButtonColor ColorGroup
MenuButtonHoverBackgroundColor ColorGroup
MenuButtonHoverColor ColorGroup
Name String
SelectedTabBackgroundColor ColorGroup
SelectedTabBottomBorderColor ColorGroup
SelectedTabTextColor ColorGroup
SelectedTabTopBorderColor ColorGroup
TabBorderColor ColorGroup
TabCloseColor ColorGroup
Tag Variant

Methods

Name Parameters Returns
Constructor
Edge XUITabBarStyle
Safari XUITabBarStyle

Property Descriptions

BackgroundColor As ColorGroup

The tab bar's background colour. It is visible when tabs are dragged around.


DisabledTabBackgroundColor As ColorGroup

The colour to use for the background of a disabled tab.


DisabledTabTextColor As ColorGroup

The colour of the text on a tab when the tab is disabled.


FontName As String

The font family name to use for text in the tab bar.


FontSize As Integer

The size of the tab bar font.


HoverTabBackgroundColor As ColorGroup

The colour of the background of the tab being hovered over.


HoverTabCloseColor As ColorGroup

The color of the close icon when hovered over.


HoverTabTextColor As ColorGroup

The colour of the text in the tab being hovered over.


InactiveTabBackgroundColor As ColorGroup

The background colour of inactive tabs.


InactiveTabTextColor As ColorGroup

The text colour for inactive tabs.


MenuButtonBackgroundColor As ColorGroup

The background colour of the optional tab bar menu button.


MenuButtonBorderColor As ColorGroup

The border colour of the optional tab bar menu button.


MenuButtonColor As ColorGroup

If the menu button has no icon, this is the colour of the drawn icon.


MenuButtonHoverBackgroundColor As ColorGroup

The background colour of the optional tab bar menu button when hovered over.


MenuButtonHoverColor As ColorGroup

If the menu button has no icon, this is the colour of the drawn icon when hovered over.


Name As String

An optional name for this style.


SelectedTabBackgroundColor As ColorGroup

The colour to use for the currently selected tab's background.


SelectedTabBottomBorderColor As ColorGroup

If the currently selected tab has a bottom border (determined by the renderer) then this is the colour to use.


SelectedTabTextColor As ColorGroup

The colour of the text on the currently selected tab.


SelectedTabTopBorderColor As ColorGroup

If the currently selected tab has a top border (determined by the renderer) then this is the colour to use.


TabBorderColor As ColorGroup

The colour to use for the borders of a tab.


TabCloseColor As ColorGroup

The color of the close icon when not hovered over.


Tag As Variant

Optional arbitrary data associated with this style.


Method Descriptions

Constructor()

Default constructor.


Edge() As XUITabBarStyle This method is shared.

Creates and returns a new style that mimics the tabs seen in Microsoft's Edge.


Safari() As XUITabBarStyle This method is shared.

Creates and returns a new style that mimics the tabs seen in Safari.