windowsforms-15635-common-features-application-appearance-and-skin-colors-glyph-skinning.md
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.
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
| |
|
BarHeaderItem.ImageOptions.AllowGlyphSkinning
RibbonControl.AllowGlyphSkinning
BaseGallery.AllowGlyphSkinning
| |
Backstage items
|
BackstageViewControl.AllowGlyphSkinning
BackstageViewItem.AllowGlyphSkinning
| |
Dock Manager panels
|
DockManager.AllowGlyphSkinning
DockPanel.ImageOptions.AllowGlyphSkinning
| |
Application UI Manager documents
|
IBaseDocumentDefaultProperties.AllowGlyphSkinning
IBaseDocumentProperties.AllowGlyphSkinning
| |
Tile Nav Pane items
|
TileNavPane.AllowGlyphSkinning
TileNavPaneDropDownOptions.AllowGlyphSkinning
NavElement.ImageOptions.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.ImageOptions.AllowGlyphSkinning
| |
Tile Control and WindowsUI View tiles
|
TileControl.AllowGlyphSkinning
| |
Tab Control tabs
|
XtraTabControl.AllowGlyphSkinning
XtraTabPage.ImageOptions.AllowGlyphSkinning
| |
XtraGrid
|
Data Grid columns and bands
|
GridOptionsView.AllowGlyphSkinning
| |
XtraLayout
|
Layout items and groups
|
OptionsView.AllowGlyphSkinning
LayoutGroup.ImageOptions.AllowGlyphSkinning
LayoutControlItem.ImageOptions.AllowGlyphSkinning
| |
XtraNavBar
|
Navigation Bar elements
|
NavBarControl.AllowGlyphSkinning
NavElement.ImageOptions.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.ImageOptions.AllowGlyphSkinning
| |
Context buttons
|
ContextItem.AllowGlyphSkinning
| |
Popup menu items
|
DXMenuItem.ImageOptions.AllowGlyphSkinning
| |
Flyout Panel buttons
|
FlyoutPanelButtonOptions.AllowGlyphSkinning
| |
GroupControl headers
|
GroupControl.ImageOptions.AllowGlyphSkinning
|
See Also