GroupControl.AllowBorderColorBlending Property

Gets or sets whether to colorize the group caption and border with the BorderColor setting in skinning paint schemes. This property is ignored by default starting from v18.2.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.Utils.v24.1.dll

NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core

Declaration

C#

[Browsable(false)]
[DefaultValue(false)]
[EditorBrowsable(EditorBrowsableState.Advanced)]
public virtual bool AllowBorderColorBlending { get; set; }

VB.NET

<DefaultValue(False)>
<Browsable(False)>
<EditorBrowsable(EditorBrowsableState.Advanced)>
Public Overridable Property AllowBorderColorBlending As Boolean

Property Value

Type	Default	Description
Boolean	false	true, to apply a custom color to the group control’s border and caption background in skinning paint schemes; otherwise, false.

Remarks

Use the GroupControl.AppearanceCaption.BorderColor property (accessible from GroupControl.AppearanceCaption) to customize the control’s caption and border color.

C#

groupControl1.AppearanceCaption.BorderColor = Color.MediumOrchid;

VB.NET

GroupControl1.AppearanceCaption.BorderColor = Color.MediumOrchid

Starting from version 18.2, the AllowBorderColorBlending property is ignored by default. You do not need to enable this option to change the control’s caption and border color.

The GroupControl takes the AllowBorderColorBlending property into account in the following cases:

• WindowsFormsSettings.BackgroundSkinningMode setting is set to Legacy
• WindowsFormsSettings.DefaultSettingsCompatibilityMode property is set to version “v18_1” or earlier.

In these cases, the AllowBorderColorBlending property functions as follows. When the property equals false, the control’s caption and border are colored based on the currently applied skin. Set the AllowBorderColorBlending property to true to enable card caption/border color customization (using the GroupControl.AppearanceCaption.BorderColor property).