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. |
|
| False | The value is false. |
|
| Default | The value is specified by a global option or a higher-level object. |
|
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.
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.