corelibraries-devexpress-dot-xtragauges-dot-core-dot-model-dot-linearscale-8225efdc.md
Provides access to the collection of text labels displayed on the same layer as the current scale.
Namespace : DevExpress.XtraGauges.Core.Model
Assembly : DevExpress.XtraGauges.v25.2.Core.dll
NuGet Package : DevExpress.Gauges.Core
public virtual LabelCollection Labels { get; }
Public Overridable ReadOnly Property Labels As LabelCollection
| Type | Description |
|---|---|
| LabelCollection |
A LabelCollection object that contains text labels.
|
Each item in the collection represents a label, and provides settings to specify a label’s text, positon, size and appearance settings.
The following example shows how to create a scale value label for a linear gauge. The label will indicate the scale’s current value, formatted in a specific manner.
In the example, the label is added via the LinearScale.Labels collection. The result is shown below:
using DevExpress.XtraGauges.Win.Base;
using DevExpress.XtraGauges.Core.Drawing;
using DevExpress.XtraGauges.Core.Model;
linearScaleComponent1.BeginUpdate();
// Create a label.
ScaleLabel label = new ScaleLabel();
label.Name = "MyLabel";
label.Position = new DevExpress.XtraGauges.Core.Base.PointF2D(160, 125);
label.AppearanceText.TextBrush = new SolidBrushObject("Color:Black");
// Enable HTML formattings and format the label's text via the FormatString property.
label.AllowHTMLString = true;
label.Text = "";
label.FormatString = "T=<b>{1:F0}°</b>";
// Add the label to the scale.
linearScaleComponent1.Labels.Add(label);
linearScaleComponent1.EndUpdate();
Imports DevExpress.XtraGauges.Win.Base
Imports DevExpress.XtraGauges.Core.Drawing
Imports DevExpress.XtraGauges.Core.Model
linearScaleComponent1.BeginUpdate()
' Create a label.
Dim label As ScaleLabel = New ScaleLabel()
label.Name = "MyLabel"
label.Position = New DevExpress.XtraGauges.Core.Base.PointF2D(160, 125)
label.AppearanceText.TextBrush = New SolidBrushObject("Color:Black")
' Enable HTML formattings and format the label's text via the FormatString property.
label.AllowHTMLString = True
label.Text = ""
label.FormatString = "T=<b>{1:F0}°</b>"
' Add the label to the scale.
linearScaleComponent1.Labels.Add(label)
linearScaleComponent1.EndUpdate()
See Also