Applies to
RibbonBar controls
Description
Specifies the theme of the RibbonBar.
Default is 0. Values are:
0 -- Default (Currently the default is mapping to Flat Design Blue)
1 -- Flat Design Blue
2 -- Flat Design Dark
3 -- Flat Design Grey
4 -- Flat Design Silver
5 -- Flat Design Lime
6 -- Flat Design Orange
The RibbonBar's appearance is determined either by the application's theme settings (if defined) or by the BuiltinTheme property (if no application theme is set):
-
If the application has a theme:
The RibbonBar always follows the applicationʼs theme and supports user customization (as defined in
theme.jsonandtheme-[xxxx].json). The BuiltinTheme property is ignored. -
If the application does not have a theme:
The RibbonBar falls back to either its default theme (BuiltinTheme = 0) or one of its built-in themes (BuiltinTheme = 1-6).
The built-in RibbonBar themes are hard-coded and cannot be modified (unlike application themes which can be customized through
theme.jsonortheme-[xxxx].json).
Usage
In a painter
To set BuiltinTheme property for RibbonBar:
-
Select the RibbonBar control.
-
Select a theme from the BuiltinTheme list on the General page of the control's Properties view.
In scripts
This statement selects the Flat Design Dark theme for the RibbonBar control:
rbb_1.BuiltinTheme = 2
