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.