RibbonControl.ColorScheme Property
Gets or sets the color applied to specific RibbonControl elements.
Namespace: DevExpress.XtraBars.Ribbon
Assembly: DevExpress.XtraBars.v24.2.dll
Declaration
[DXCategory("Appearance")]
[XtraSerializableProperty]
public RibbonControlColorScheme ColorScheme { get; set; }Property Value
| Type | Description |
|---|---|
| RibbonControlColorScheme | A RibbonControlColorScheme enumerator value that specifies the color applied to specific RibbonControl elements. |
Available values:
| Name | Description |
|---|---|
| Yellow | The Yellow color scheme. |
| Blue | The Blue color scheme. |
| Green | The Green color scheme. |
| Orange | The Orange color scheme. |
| Purple | The Purple color scheme. |
| Default | All Ribbon elements are painted with their default skin colors. |
| Teal | The Teal color scheme. |
| Red | The Red color scheme. |
| DarkBlue | The DarkBlue color scheme. |
Remarks
The ColorScheme property allows you to apply color variations to a RibbonControl. This property is in effect only for “Office 2010”, “Office 2013”, and “Office 2016” skins.
The color you choose is applied to different Ribbon elements, depending on the currently active skin. Affected Ribbon UI elements include:
- the backstage menu and its items;
- application button;
- selected gallery items;
- header and borders of the parent RibbonForm.
This color affects only non-grayscale elements. For this reason, the ColorScheme property has the most drastic impact on the “Office 2016 Colorful” skin and is less noticeable in other skins.
Office 2016 Colorful
Green hue
Office 2016 Dark
Green hue
Office 2016 Black
Green hue
Office 2013 White
Red hue
Office 2013 Light Gray
Red hue
Office 2013 Dark Gray
Red hue
The ColorScheme property has no effect on Ribbons with the “Office 2007” Ribbon style and overrides custom skin color settings (see the “Color Mixer” section of theSkins article).
Tip
The ColorScheme property affects all Ribbons in a project. If you want to colorize multiple Ribbons differently, add a BarAndDockingController component for each Ribbon, then set the UserLookAndFeel.UseDefaultLookAndFeel property of each component to false. Utilize the component’s BarAndDockingControllerLookAndFeel.ColorScheme properties to specify unique color schemes for Ribbons associated with these BarAndDockingController components.