XRControl.ForeColor Property

Gets or sets the control's foreground color.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v18.1.dll

Syntax

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

Returns

Type Description
Color

A Color object that represents the foreground color.

The ForeColor property specifies the control's foreground color (e.g. the color of the text in XRLabel or the color of the line in XRLine), while the control's background color is specified by its XRControl.BackColor property.

If the ForeColor property's value is not set for the current report control, its value is obtained from its parent, or a parent of its parent and so on. Similarly, the ForeColor value of the current control is applied to all its child report controls (if there are any in its XRControl.Controls collection), if their ForeColor property value is not set. For more information on this concept, please refer to Appearance Properties.

Note

The ForeColor property is used only by some descendants of the XRControl class. For example, the XRPageBreak class ignores the ForeColor property.

Examples

This example demonstrates how to create a hyperlink in a report. Note that such label behaves as a hyperlink both in a report's Print Preview and HTML, PDF, RTF, XLS and XLSX formats.

To add a hyperlink, to the Report Detail Band, handle the Report's XRControl.BeforePrint event in the following way.

using DevExpress.XtraReports.UI;
// ...

private void XtraReport1_BeforePrint(object sender, System.Drawing.Printing.PrintEventArgs e) {
    // Create a new hyperlink and add it to the report's Detail Band.
    Bands.GetBandByType(typeof(DetailBand)).Controls.Add(CreateHyperlink());
}

The code below creates a hyperlink using the XRLabel object, and specifies its XRControl.NavigateUrl, XRControl.Target and other properties.

using System.Drawing;
using DevExpress.XtraReports.UI;
// ...

public XRLabel CreateHyperlink(){
    // Create a label for a hyperlink.
    XRLabel hyperlinkLabel = new XRLabel();

    // Set its main properties.
    hyperlinkLabel.Text = "DevExpress Inc.";
    hyperlinkLabel.Width = 200;
    hyperlinkLabel.ForeColor = Color.Blue;
    hyperlinkLabel.Font = new Font("Tahoma", 12, FontStyle.Underline);

    // Set its URL and target.
    hyperlinkLabel.NavigateUrl = "http://www.devexpress.com";
    hyperlinkLabel.Target = "_blank";

    return hyperlinkLabel;
}

See Also