XRControl.BackColor Property

Gets or sets a control’s background color.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v23.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.

Appearance properties specified for bands or panels propagate to child controls, even though they may not take effect for some report elements. An obvious example of this behavior is the DetailBand element, that has no visible border or background color, even though it passes appearance property settings to its child controls. Another example is the XRPageBreak control, that has the XRControl.BackColor property, but ignores its value during rendering.

Review the following help topic for more information: Appearance Properties.

If a report element has a 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#L41

private void ApplyAppearanceSettings(XRLabel label) {
    label.BackColor = Color.Orange;
    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#L41

Private Sub ApplyAppearanceSettings(ByVal label As XRLabel)
    label.BackColor = Color.Orange
    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)