Skip to main content

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.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[Browsable(false)]
[DefaultValue(DefaultBoolean.Default)]
[EditorBrowsable(EditorBrowsableState.Never)]
[XtraSerializableProperty]
public DefaultBoolean AllowGlyphSkinning { get; set; }

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.

Available values:

Name Description Return Value
True

The value is true.

0

False

The value is false.

1

Default

The value is specified by a global option or a higher-level object.

2

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