Label.Text Property
Gets or sets the label’s text.
Namespace: DevExpress.XtraGauges.Core.Model
Assembly: DevExpress.XtraGauges.v24.2.Core.dll
NuGet Package: DevExpress.Gauges.Core
#Declaration
#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:
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();