LabelControl.Text Property

Gets or sets the label’s text.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v19.1.dll

Declaration

C#

[DXCategory("Appearance")]
[SettingsBindable(true)]
[SmartTagProperty("Text", "", SmartTagActionType.RefreshBoundsAfterExecute)]
public override string Text { get; set; }

VB.NET

<DXCategory("Appearance")>
<SettingsBindable(True)>
<SmartTagProperty("Text", "", SmartTagActionType.RefreshBoundsAfterExecute)>
Public Overrides Property Text As String

Property Value

Type	Description
String	A String value that specifies the label’s text.

Remarks

If the LabelControl.AllowHtmlString property is set to true, you can use HTML tags to format the Text. For detailed information, see HTML Text Formatting.

Note

Long words are not wrapped if the Text option is enabled.

Example

The following example shows how to format a LabelControl‘s text using HTML tags. HTML formatting is enabled via the LabelControl.AllowHtmlString property. To respond to an end-user clicking the hyperlink, the LabelControl.HyperlinkClick event is handled. The image below shows the result:

C#

labelControl1.Text = "<size=14>Size = 14<br>" +
                     "<b>Bold</b> <i>Italic</i> <u>Underline</u><br>" + 
                     "<size=11>Size = 11<br>" + 
                     "<color=255, 0, 0>Sample Text</color></size>" +
                     "<href=www.devexpress.com>Hyperlink</href>";
labelControl1.AllowHtmlString = true;
labelControl1.Appearance.TextOptions.WordWrap = DevExpress.Utils.WordWrap.Wrap;
labelControl1.Appearance.Options.UseTextOptions = true;
labelControl1.AutoSizeMode = DevExpress.XtraEditors.LabelAutoSizeMode.Vertical;

private void labelControl1_HyperlinkClick(object sender, DevExpress.Utils.HyperlinkClickEventArgs e) {
    System.Diagnostics.Process.Start(e.Link);
}

VB.NET

labelControl1.Text = "<size=14>Size = 14<br>" + _
                     "<b>Bold</b> <i>Italic</i> <u>Underline</u><br>" +  _
                     "<size=11>Size = 11<br>" + _
                     "<color=255, 0, 0>Sample Text</color></size><br>" + _
                     "<href=www.devexpress.com>Hyperlink</href>"
labelControl1.AllowHtmlString = True
labelControl1.Appearance.TextOptions.WordWrap = DevExpress.Utils.WordWrap.Wrap
labelControl1.Appearance.Options.UseTextOptions = True
labelControl1.AutoSizeMode = DevExpress.XtraEditors.LabelAutoSizeMode.Vertical

Private Sub LabelControl1_HyperlinkClick(sender As Object, e As DevExpress.Utils.HyperlinkClickEventArgs) Handles LabelControl1.HyperlinkClick
    System.Diagnostics.Process.Start(e.Link)
End Sub

Related GitHub Examples

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.

C#

custom-editor-how-to-create-a-fileedit-e4097/CS/CustomEditor/CustomPopupForm.cs#L46

public void InitializeFileInfo() {
    labelCreationDate.Text = "File created: ";
    labelModifideDate.Text = "File modified: ";

mvvm-best-practices-t228317/CS/EventToCommandBehaviorParametersConverters/PassingParametersToCommandsUserControl.cs#L23

LabelControl label = new LabelControl();
label.Text = "Click to Execute Command";
label.Dock = DockStyle.Fill;

vote-app-t445500/CS/VoteApp/VotesPanel.cs#L33

public string VotesTextLeft {
    get { return lbVotesLeft.Text; }
    set { lbVotesLeft.Text = value ?? ""; }

vote-applications-t446758/CS/VoteApp/VotesPanel.cs#L33

public string VotesTextLeft {
    get { return lbVotesLeft.Text; }
    set { lbVotesLeft.Text = value ?? ""; }

XPO_how-to-create-a-filter-with-an-aggregate-function-for-a-child-collection-e1329/CS/Form1.cs#L306

if(ReferenceEquals(criteria, null))
    labelControl1.Text = string.Empty;
else

VB.NET

custom-editor-how-to-create-a-fileedit-e4097/VB/CustomEditor/CustomPopupForm.vb#L52

Public Sub InitializeFileInfo()
    labelCreationDate.Text = "File created: "
    labelModifideDate.Text = "File modified: "

mvvm-best-practices-t228317/VB/EventToCommandBehaviorParametersConverters/PassingParametersToCommandsUserControl.vb#L23

Dim label As New LabelControl()
label.Text = "Click to Execute Command"
label.Dock = DockStyle.Fill

XPO_how-to-create-a-filter-with-an-aggregate-function-for-a-child-collection-e1329/VB/Form1.vb#L291

If ReferenceEquals(criteria, Nothing) Then
    labelControl1.Text = String.Empty
Else

XPO_how-to-filter-a-collection-by-an-associated-objects-properties-e886/VB/Form1.vb#L295

If ReferenceEquals(criteria, Nothing) Then
    labelControl1.Text = String.Empty
Else

how-to-customize-the-appointment-flyout-t579967/VB/CustomAppointmentFlyoutExample/MyFlyout.vb#L23

Me.labelControl1.Text = subject
Me.labelControl2.Text = start.ToString()