Back to Devexpress

RibbonControl.ColorScheme Property

windowsforms-devexpress-dot-xtrabars-dot-ribbon-dot-ribboncontrol-a7cdfebb.md

latest5.3 KB
Original Source

RibbonControl.ColorScheme Property

Gets or sets the color applied to specific RibbonControl elements.

Namespace : DevExpress.XtraBars.Ribbon

Assembly : DevExpress.XtraBars.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

csharp
[DXCategory("Appearance")]
[XtraSerializableProperty]
public RibbonControlColorScheme ColorScheme { get; set; }
vb
<DXCategory("Appearance")>
<XtraSerializableProperty>
Public Property ColorScheme As RibbonControlColorScheme

Property Value

TypeDescription
RibbonControlColorScheme

A RibbonControlColorScheme enumerator value that specifies the color applied to specific RibbonControl elements.

|

Available values:

NameDescription
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:

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.

See Also

ColorScheme

ApplicationButtonDropDownControl

ColorSchemeChanged

RibbonControl Class

RibbonControl Members

DevExpress.XtraBars.Ribbon Namespace