Glyph Skinning

• Jan 09, 2023
• 2 minutes to read

The Glyph Skinning feature allows you to paint icons within DevExpress WinForms UI controls according to a control’s foreground color (or a background color for badges), which is typically determined by the currently applied skin. This feature can assist you in creating modern monochrome interfaces for your applications. All you need to do is follow two simple steps.

1. Choose a gray-scale icon from the DevExpress Image Gallery or use your own monochrome icon for all desired UI elements.
2. Set the AllowGlyphSkinning property of the required object (BarItem, RibbonControl, NavBarControl, etc.) to true.

After the AllowGlyphSkinning property is set to true, all icons gain a color hue, specified via the object’s foreground color. The image below illustrates a RibbonControl painted with the Glyph Skinning feature in different Skins.

Important

The Glyph Skinning feature is designed to be used with raster icons only. Vector icons are automatically colorized using skin palette colors.

Refer to the Bar and Ribbon Glyph Skinning topic for a detailed description of how to implement this feature for your BarManager or RibbonControl. To use Glyph Skinning in other controls that support this feature (e.g., a NavBarControl), follow the same steps and use the related AllowGlyphSkinning property. The table below lists all controls that support the Glyph Skinning feature and their AllowGlyphSkinning properties.

Library	Glyph Skinning can be applied to…	Property List
Ribbon, Menu and Docking	Accordion Control elements	AccordionControl.AllowGlyphSkinning AccordionControlElementBase.AllowGlyphSkinning
	Bar items and links	BarItem.AllowGlyphSkinning BarHeaderItem.AllowGlyphSkinning BarManager.AllowGlyphSkinning RibbonControl.AllowGlyphSkinning BaseGallery.AllowGlyphSkinning RadialMenu.AllowGlyphSkinning
	Backstage items	BackstageViewControl.AllowGlyphSkinning BackstageViewItem.AllowGlyphSkinning
	Dock Manager panels	DockManager.AllowGlyphSkinning DockPanel.AllowGlyphSkinning
	Application UI Manager documents	IBaseDocumentDefaultProperties.AllowGlyphSkinning IBaseDocumentProperties.AllowGlyphSkinning
	Tile Nav Pane items	TileNavPane.AllowGlyphSkinning TileNavPaneDropDownOptions.AllowGlyphSkinning NavElement.AllowGlyphSkinning
	Navigation Pane page headers	NavigationPane.AllowGlyphSkinning
	Office Navigation Bar items (in Compact mode only)	OfficeNavigationBar.AllowGlyphSkinning
	Tab Form pages	TabFormControlBase.AllowGlyphSkinning TabFormPage.AllowGlyphSkinning
	WindowsUI Button Panel buttons	WindowsUIButtonPanel.AllowGlyphSkinning
	Tabbed MDI Manager tabs	XtraTabbedMdiManager.AllowGlyphSkinning XtraMdiTabPage.AllowGlyphSkinning
Editors	Labels	LabelControl.AllowGlyphSkinning
	ButtonEdit and other editors, whose repositories deriver from the RepositoryItemButtonEdit class	RepositoryItemButtonEdit.AllowGlyphSkinning
	Buttons	SimpleButton.AllowGlyphSkinning
	Tile Control and WindowsUI View tiles	TileControl.AllowGlyphSkinning TileItem.AllowGlyphSkinning
	Tab Control tabs	XtraTabControl.AllowGlyphSkinning XtraTabPage.AllowGlyphSkinning
XtraGrid	Data Grid columns and bands	GridOptionsView.AllowGlyphSkinning
XtraLayout	Layout items and groups	OptionsView.AllowGlyphSkinning LayoutGroup.AllowGlyphSkinning LayoutControlItem.AllowGlyphSkinning
XtraNavBar	Navigation Bar elements	NavBarControl.AllowGlyphSkinning NavElement.AllowGlyphSkinning
XtraPivotGrid	Pivot Grid icons	PivotGridOptionsView.AllowGlyphSkinning
XtraTreeList	Tree List columns and nodes	TreeListOptionsView.AllowGlyphSkinning
XtraVerticalGrid	Vertical Grid rows and bands	CustomDrawRowHeaderCellEventArgs.AllowGlyphSkinning
Utils	Adorner UI Manager badges	BadgeProperties.AllowGlyphSkinning BadgeDefaultProperties.AllowGlyphSkinning
	Context buttons	ContextItem.AllowGlyphSkinning
	Popup menu items	DXMenuItem.AllowGlyphSkinning
	Flyout Panel buttons	FlyoutPanelButtonOptions.AllowGlyphSkinning
	GroupControl headers	GroupControl.AllowGlyphSkinning