Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

DockPanel.AllowCustomHeaderButtonsGlyphSkinning Property

Gets or sets whether Custom Header Button icons should be painted according to the currently applied skin. This property is obsolete. Use the DockPanel.ImageOptions.AllowCustomHeaderButtonsGlyphSkinning property instead.

Namespace: DevExpress.XtraBars.Docking

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

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

#Property Value

Type Default Description
DefaultBoolean Default

true if Custom Header Button icons should be painted according to the currently applied skin; otherwise, false.

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

The DockPanel.ImageOptions.AllowGlyphSkinning property allows you to paint panel icons in this panel’s foreground color. This property affects icons within panel caption, the tab header and auto-hide header. To apply the Glyph Skinning to the Custom Header Button icons, use the AllowCustomHeaderButtonsGlyphSkinning property instead.

The AllowCustomHeaderButtonsGlyphSkinning property’s main objective is to paint Custom Header Button icons in an application Skin‘s colors. Use it to implement your own custom buttons that look exactly like default buttons (close, auto-hide, maximize). However, you can use it to paint monochrome icons in your own custom colors. To do this, access the IButtonProperties.Appearance section of the desired items within the DockPanel.CustomHeaderButtons collection.

The animation below illustrates a DockPanel with two default and one custom header button. All three buttons are painted in the same pattern according to the currently applied skin (Office 2013).

See the Glyph Skinning topic to see all controls that support the Glyph Skinning Feature.

See Also