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