AppearanceOptions.UseBorderColor Property

Gets or sets whether to use the AppearanceObject.BorderColor property value.

Namespace: DevExpress.Utils

Assembly: DevExpress.Utils.v24.2.dll

Declaration

C#

[DefaultValue(false)]
[DXCategory("Appearance")]
[XtraSerializableProperty]
public virtual bool UseBorderColor { get; set; }

VB.NET

<DefaultValue(False)>
<XtraSerializableProperty>
<DXCategory("Appearance")>
Public Overridable Property UseBorderColor As Boolean

Property Value

Type	Default	Description
Boolean	false	true to use the AppearanceObject.BorderColor property value; false to use the border color specified by the parent appearance object.

Property Paths

You can access this nested property as listed below:

Object Type	Path to UseBorderColor
AppearanceObject	.Options .UseBorderColor
AppearanceOptions	.Empty .UseBorderColor

Remarks

If the current appearance object has no parent, the AppearanceObject.BorderColor property value is used regardless of the UseBorderColor property setting. Please refer to the Look and Feel topic for details.

When an AppearanceObject’s style setting (for example, BackColor, ForeColor, Font and TextOptions.HAlignment) is set to a non-default value, the corresponding Options.Use… option (for instance, Options.UseBackColor, Options.UseForeColor, Options.UseFont and Options.UseTextOptions) is automatically set to true in the following cases:

• The AppearanceObject belongs to a control/component (or its element), and this control/component has been completely loaded (see the control’s IsLoading property to check the load status);
• The AppearanceObject belongs to a grid column/band or tree list column/band, and the column/band belongs to a grid/tree list control;
• The AppearanceObject is standalone, that is, it does not belong to any control or component.

In other cases, the Options.Use… options are not automatically enabled. You may need to enable these options manually for the style settings to be in effect.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the UseBorderColor property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-grid-print-export-custom-painted-content/CS/MyXtraGrid/MyGridView/MyGridViewPrintInfo.cs#L68

BorderSide border = args.Appearance.Options.UseBorderColor ? BorderSide.All : BorderSide.None;
ib = new ImageBrick(border, 1, args.Appearance.BorderColor, args.Appearance.BackColor);

winforms-grid-print-custom-draw-content/CS/MyXtraGrid/MyGridView/MyGridViewPrintInfo.cs#L57

    return null;
BorderSide border = args.Appearance.Options.UseBorderColor? BorderSide.All: BorderSide.None;
ImageBrick ib = new ImageBrick(border, 1, args.Appearance.BorderColor, args.Appearance.BackColor);

VB.NET

winforms-grid-print-export-custom-painted-content/VB/MyXtraGrid/MyGridView/MyGridViewPrintInfo.vb#L64

Dim border As BorderSide = If(args.Appearance.Options.UseBorderColor, BorderSide.All, BorderSide.None)
ib = New ImageBrick(border, 1, args.Appearance.BorderColor, args.Appearance.BackColor)

winforms-grid-print-custom-draw-content/VB/MyXtraGrid/MyGridView/MyGridViewPrintInfo.vb#L58

End If
Dim border As BorderSide = If(args.Appearance.Options.UseBorderColor, BorderSide.All, BorderSide.None)
Dim ib As New ImageBrick(border, 1, args.Appearance.BorderColor, args.Appearance.BackColor)