Skip to main content

Label.Text Property

Gets or sets the label’s text.

Namespace: DevExpress.XtraGauges.Core.Model

Assembly: DevExpress.XtraGauges.v22.2.Core.dll

NuGet Package: DevExpress.Gauges.Core

Declaration

[DefaultValue("Text")]
public string Text { get; set; }

Property Value

Type Default Description
String "Text"

A string that specifies the label’s text.

Remarks

The display text is formed according the Label.FormatString property. By default, it’s set to {0}, where the {0} placeholder specifies the value of the Text property. So, by default, the value of the Text property is displayed as is.

A label’s text can be formatted using HTML tags. For instance, you can mark specific portions of text bold or italic, change the font and font color, etc. To enable HTML formatting, set the Label.AllowHTMLString property to true. See HTML Text Formatting, to learn more.

Example

The following code shows how to add a static label (LabelComponent) to a circular gauge. The label displays custom text and formats its appearance using HTML tags.

The result is shown below:

Label_Static_ex

using DevExpress.XtraGauges.Win.Base;
using DevExpress.XtraGauges.Core.Drawing;

circularGauge1.BeginUpdate();
LabelComponent label = new LabelComponent("myLabel");
label.AppearanceText.TextBrush = new SolidBrushObject(Color.Black);
label.Position = new DevExpress.XtraGauges.Core.Base.PointF2D(125, 210);
label.ZOrder = -10000;
label.AllowHTMLString = true;
label.Text = "<color=RED>MPH</color> <b>/</b> <color=BLUE>KM/H</color>";
circularGauge1.Labels.Add(label);
circularGauge1.EndUpdate();

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

See Also