XRControl.Font Property

Gets or sets the control’s font.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v23.2.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

C#

[SRCategory(ReportStringId.CatAppearance)]
[XRLocalizable(true)]
public virtual DXFont Font { get; set; }

VB.NET

<SRCategory(ReportStringId.CatAppearance)>
<XRLocalizable(True)>
Public Overridable Property Font As DXFont

Property Value

Type	Description
DXFont	An object that contains font information.

Remarks

The Font property specifies the font of the control’s XRControl.Text, while the text alignment is specified by the XRControl.TextAlignment property.

If the Font 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 Font value of the current control is applied to all its child report controls (if there are any in its XRControl.Controls collection), if their Font property value is not set. For more information on this concept, please refer to Appearance Properties.

Note

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

Example

This example demonstrates how to use the XRLabel control to create a hyperlink.

The code below creates the XRLabel control, sets up its appearance, and specifies its NavigateUrl and Target properties.

C#

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 = "https://www.devexpress.com/";
    hyperlinkLabel.Target = "_blank";

    return hyperlinkLabel;
}

VB.NET

Imports System.Drawing
Imports DevExpress.XtraReports.UI
' ...

Public Function CreateHyperlink() As XRLabel
    ' Create a label for a hyperlink.
    Dim hyperlinkLabel As XRLabel = 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 = "https://www.devexpress.com/"
    hyperlinkLabel.Target = "_blank"

    Return hyperlinkLabel
End Function

To add the hyperlink to the report’s Detail band, handle the report’s BeforePrint event:

C#

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

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

VB.NET

Imports DevExpress.XtraReports.UI
' ...

Private Sub XtraReport1_BeforePrint(ByVal sender As Object, ByVal e As System.ComponentModel.EventArgs)
    Create a new hyperlink and add it to the report's Detail Band.
    Bands.GetBandByType(GetType(DetailBand)).Controls.Add(CreateHyperlink())
End Sub

The label behaves like a hyperlink in a report’s Print Preview and in a document exported to HTML, PDF, RTF, XLS, and XLSX formats.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Font 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-wpf-create-report-in-code/CS/RuntimeReportsApplication/MainWindow.xaml.cs#L74

XRLabel label = new XRLabel();
label.Font = new Font("Tahoma", 12, System.Drawing.FontStyle.Bold);
label.Text = caption;

reporting-web-forms-handle-server-side-errors/CS/DXWebApplication1/Reports/XtraReport3.cs#L73

    this.Detail});
this.Font = new System.Drawing.Font("Arial", 9.75F);
this.Version = "18.2";

reporting-winforms-sql-data-source-runtime/CS/RuntimeSqlDataSourceReportSample/ReportCreator.cs#L35

XRLabel label = new XRLabel();
label.Font = new Font("Tahoma", 12, FontStyle.Bold);
label.Text = caption;

winforms-create-a-custom-exporter-for-pivotgridcontrol-with-xtrareport/CS/Report_at_Runtime/PivotReportGenerator.cs#L216

XRTable table = new XRTable();
table.Font = font;
table.Height = 20;

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

label.BorderWidth = 0.5f;
label.Font = new Font(label.Parent.Font, FontStyle.Bold);
label.ForeColor = Color.White;

VB.NET

reporting-wpf-create-report-in-code/VB/RuntimeReportsApplication/MainWindow.xaml.vb#L83

Dim label As New XRLabel()
label.Font = New Font("Tahoma", 12, System.Drawing.FontStyle.Bold)
label.Text = caption

reporting-web-forms-handle-server-side-errors/VB/DXWebApplication1/Reports/XtraReport3.vb#L68

Me.Bands.AddRange(New DevExpress.XtraReports.UI.Band() { Me.TopMargin, Me.BottomMargin, Me.Detail})
Me.Font = New System.Drawing.Font("Arial", 9.75F)
Me.Version = "18.2"

reporting-winforms-sql-data-source-runtime/VB/RuntimeSqlDataSourceReportSample/ReportCreator.vb#L38

Dim label As New XRLabel()
label.Font = New Font("Tahoma", 12, FontStyle.Bold)
label.Text = caption

winforms-create-a-custom-exporter-for-pivotgridcontrol-with-xtrareport/VB/Report_at_Runtime/PivotReportGenerator.vb#L221

Dim table As DevExpress.XtraReports.UI.XRTable = New DevExpress.XtraReports.UI.XRTable()
table.Font = font
table.Height = 20

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

label.BorderWidth = 0.5F
label.Font = New Font(label.Parent.Font, FontStyle.Bold)
label.ForeColor = Color.White