windowsforms-devexpress-dot-xtrabars-dot-docking-dot-dockpanel-71c7f712.md
Gets or sets whether the current DockPanel icon should be painted in this panel’s foreground color. This property is obsolete. Use the DockPanel.ImageOptions.AllowGlyphSkinning property instead.
Namespace : DevExpress.XtraBars.Docking
Assembly : DevExpress.XtraBars.v25.2.dll
NuGet Package : DevExpress.Win.Navigation
[Browsable(false)]
[DefaultValue(DefaultBoolean.Default)]
[EditorBrowsable(EditorBrowsableState.Never)]
[XtraSerializableProperty]
public DefaultBoolean AllowGlyphSkinning { get; set; }
<Browsable(False)>
<EditorBrowsable(EditorBrowsableState.Never)>
<XtraSerializableProperty>
<DefaultValue(DefaultBoolean.Default)>
Public Property AllowGlyphSkinning As DefaultBoolean
| 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
|
DockPanels display their icons (DockPanel.ImageOptions.Image) 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.ImageOptions.AllowGlyphSkinning = DevExpress.Utils.DefaultBoolean.True;
dockManager1.Controller.AppearancesDocking.ActiveTab.ForeColor = Color.DodgerBlue
dockManager1.AllowGlyphSkinning = true
'or
dockPanel1.ImageOptions.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.ImageOptions.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