DockPanel.AllowGlyphSkinning Property

Gets or sets whether the current DockPanel icon should be painted in this panel's foreground color.

Namespace: DevExpress.XtraBars.Docking

Assembly: DevExpress.XtraBars.v20.1.dll

Declaration

[Browsable(false)]
[XtraSerializableProperty]
[DefaultValue(DefaultBoolean.Default)]
public DefaultBoolean AllowGlyphSkinning { get; set; }
<Browsable(False)>
<XtraSerializableProperty>
<DefaultValue(DefaultBoolean.Default)>
Public Property AllowGlyphSkinning As DefaultBoolean

Property Value

Type Default Description
DefaultBoolean

Default

A DefaultBoolean enumerator value that specifies whether the current DockPanel icon should be painted in this panel's foreground color.

Remarks

DockPanels display their icons (see the DockPanel.Image property) only within a Document Selector, panel caption (when the panel is set to auto-hidden) or tab header (when the panel is presented as a tab). Icons can be painted in the foreground colors of these panels if the AllowGlyphSkinning property equals true. This property overrides the DockManager.AllowGlyphSkinning property, which manages the Glyph Skinning feature for the entire DockManager.

To specify a DockPanel's foreground color, use the BarAndDockingController.AppearancesDocking properties section of a BarAndDockingController object assigned to a DockManager. To get or set this controller for a specific DockManager, use the DockManager.Controller property.

The figure and code below illustrate a DockPanel, presented as a tab. Its active tab's text and icon are painted in the same color.

DockManager - AllowGlyphSkinning


dockManager1.Controller.AppearancesDocking.ActiveTab.ForeColor = Color.DodgerBlue;
dockManager1.AllowGlyphSkinning = true;
//or
dockPanel1.AllowGlyphSkinning = DevExpress.Utils.DefaultBoolean.True;

For best visual results, we recommend the gray-scale icons from the DevExpress Image Gallery when using the Glyph Skinning.

The AllowGlyphSkinning property does not affect Header Buttons icons. To enable Glyph Skinning for these buttons, use the DockPanel.AllowCustomHeaderButtonsGlyphSkinning property instead.

DockManager is not the only control that supports this feature. Refer to the Glyph Skinning topic for the complete control list.

See Also