RibbonControl.ColorScheme Property

Gets or sets the color applied to specific RibbonControl elements.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v19.1.dll

Declaration

C#

[DXCategory("Appearance")]
[XtraSerializableProperty]
public RibbonControlColorScheme ColorScheme { get; set; }

VB.NET

<DXCategory("Appearance")>
<XtraSerializableProperty>
Public Property ColorScheme As RibbonControlColorScheme

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.