Skip to main content

DockManager.AllowGlyphSkinning Property

Gets or sets whether all DockPanels within the DockManager should paint their icons in the panel’s foreground colors.

Namespace: DevExpress.XtraBars.Docking

Assembly: DevExpress.XtraBars.v23.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[DefaultValue(false)]
[DXCategory("Appearance")]
[XtraSerializableProperty]
public bool AllowGlyphSkinning { get; set; }

Property Value

Type Default Description
Boolean false

true if all DockPanels within the DockManager should paint their icons in the panel’s foreground colors; otherwise, false.

Remarks

DockPanels display their icons (see the DockPanel.Image property) only within a Document Selector, panel caption (when the panel is set auto-hidden) or tab header (when the panel is presented as a tab). Icons can be painted in these panels’ foreground colors if the DockPanel.AllowGlyphSkinning property is true. The AllowGlyphSkinning property has a lower priority and enables or disables this behavior for all DockPanels within a 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.

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

See Also