XRControl.BackColor Property

Gets or sets a control’s background color.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v22.2.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

C#

[SRCategory(ReportStringId.CatAppearance)]
public virtual Color BackColor { get; set; }

VB.NET

<SRCategory(ReportStringId.CatAppearance)>
Public Overridable Property BackColor As Color

Property Value

Type	Description
Color	A Color object that is the background color. The default value is Transparent.

Remarks

The BackColor property sets the background color of the control.

If the BackColor property value is not specified, the control retrieves its value from the parent control. In the same way, the BackColor value of a control applies to all of its child report controls in the Controls collection if their BackColor property value is not specified. Review the following help topic for more information: Appearance Properties.

Note

Appearance properties may not be used by all descendants of the current report element for which they are defined. For example, class XRPageBreak ignores property XRControl.BackColor.

If a report element has style assigned to it, the priority of the properties defined by that style is determined by the StylePriority property. Note that if conditional formatting is involved, the appearance it defines has a higher priority.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the BackColor 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#

reporting-winforms-change-label-appearance-in-beforeprint-event-handler/CS/XtraReport1.cs#L21

    label.ForeColor = Color.White;
    label.BackColor = Color.Red;
}

asp-net-web-forms-grid-create-report-based-on-grid-layout/CS/WebApplication1/ReportHelper.cs#L62

report.Bands.Add(footerBand);
footerBand.BackColor = Color.LightGray;
foreach(ASPxSummaryItem item in aspxGridView1.GroupSummary) {

reporting-winforms-appearance-settings/CS/XtraReport1.cs#L27

private void SetCustomStyle(XRLabel label) {
    label.BackColor = Color.Gray;
    label.BorderColor = Color.DarkGray;

asp-net-mvc-grid-create-report-based-on-grid-layout/CS/E4755/Models/ReportHelperMVC.cs#L80

l.LocationF = new PointF(initialGroupOffset + i * 10, 0);
l.BackColor = Color.Beige;
l.SizeF = new SizeF((report.PageWidth - (report.Margins.Left + report.Margins.Right)) - (initialGroupOffset + i * subGroupOffset), bandHeight);

winforms-scheduler-print-appointments-using-reports/CS/PrintingViaReports/XtraReport1.cs#L47

Color curColor = Color.FromArgb(Int32.Parse(((XRLabel)sender).Text));
((XRLabel)sender).BackColor = curColor;
((XRLabel)sender).ForeColor = curColor;

VB.NET

reporting-winforms-change-label-appearance-in-beforeprint-event-handler/VB/XtraReport1.vb#L23

    label.ForeColor = Color.White
    label.BackColor = Color.Red
ElseIf total > 1000 Then

asp-net-web-forms-grid-create-report-based-on-grid-layout/VB/WebApplication1/ReportHelper.vb#L64

report.Bands.Add(footerBand)
footerBand.BackColor = Color.LightGray
For Each item As ASPxSummaryItem In aspxGridView1.GroupSummary

reporting-winforms-appearance-settings/VB/XtraReport1.vb#L30

Private Sub SetCustomStyle(ByVal label As XRLabel)
    label.BackColor = Color.Gray
    label.BorderColor = Color.DarkGray

reporting-winforms-group-by-days-of-week/VB/GroupByTimeSpan/Form1.vb#L48

ghLabel.DataBindings.Add("Text", report.DataSource, "OrderDate", "{0:dddd}")
ghLabel.BackColor = Color.Red
ghBand.Controls.Add(ghLabel)

asp-net-mvc-grid-create-report-based-on-grid-layout/VB/E4755/Models/ReportHelperMVC.vb#L76

l.LocationF = New PointF(initialGroupOffset + i * 10, 0)
l.BackColor = Color.Beige
l.SizeF = New SizeF((report.PageWidth - (report.Margins.Left + report.Margins.Right)) - (initialGroupOffset + i * subGroupOffset), bandHeight)