ClassRadLabel
Represents a label control that provides run-time information or descriptive text for a control.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[DefaultBindingProperty("Text")]
public class RadLabel : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider, ISupportRootUIAutomation
Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadLabel
Implements:
Inherited Members
Constructors
RadLabel()
Initializes a new instance of the RadLabel class.
Declaration
public RadLabel()
Properties
AutoSize
Gets or sets a value indicating whether the control is automatically resized to display its entire contents.
Declaration
[Browsable(true)]
public override bool AutoSize { get; set; }
Property Value
Overrides
BorderVisible
Gets or sets a value indicating whether the border is visible.
DefaultSize
Gets the default size of the control.
Declaration
protected override Size DefaultSize { get; }
Property Value
Overrides
EnableUIAutomation
Gets or sets a value indicating whether UI Automation support is enabled for the label. Default value is true.
Declaration
public override bool EnableUIAutomation { get; set; }
Property Value
Overrides
Implements
Image
Gets or sets the image that is displayed on the label.
ImageAlignment
Gets or sets the alignment of image content on the drawing surface.
Declaration
public ContentAlignment ImageAlignment { get; set; }
Property Value
ImageIndex
Gets or sets the image list index value of the image displayed on the label control.
Declaration
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
[RelatedImageList("ImageList")]
public int ImageIndex { get; set; }
Property Value
ImageKey
Gets or sets the key accessor for the image in the label.
Declaration
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
[RelatedImageList("ImageList")]
public virtual string ImageKey { get; set; }
Property Value
LabelElement
Gets the RadLabelElement that represents the visual element of this label control.
Declaration
[Browsable(false)]
public RadLabelElement LabelElement { get; }
Property Value
SvgImage
Gets or sets the SVG image displayed on the label.
TextAlignment
Gets or sets the alignment of text content on the drawing surface.
Declaration
public ContentAlignment TextAlignment { get; set; }
Property Value
TextImageRelation
Gets or sets the position of text and image relative to each other.
Declaration
public TextImageRelation TextImageRelation { get; set; }
Property Value
TextWrap
Gets or sets a value indicating whether the text should wrap to the available layout rectangle.
UseMnemonic
Gets or sets a value indicating whether the first character preceded by an ampersand will be used as the label's mnemonic key.
Methods
CreateAccessibilityInstance()
Creates the RadLabelAccessibleObject instance for this control.
Declaration
protected override AccessibleObject CreateAccessibilityInstance()
Returns
An AccessibleObject instance for this control.
Overrides
CreateChildItems(RadElement)
Creates the child items within the specified parent element.
Declaration
protected override void CreateChildItems(RadElement parent)
Parameters
parent
The parent element that will contain the child items.
Overrides
CreateLabelElement()
Creates the RadLabelElement for this control.
Declaration
protected virtual RadLabelElement CreateLabelElement()
Returns
A new RadLabelElement instance.
CreateRootElement()
Creates the root element for RadLabel control.
Declaration
protected override RootRadElement CreateRootElement()
Returns
A new RadLabelRootElement instance.
Overrides
OnNotifyPropertyChanged(string)
Raises the NotifyPropertyChanged event for the specified property.
Declaration
protected override void OnNotifyPropertyChanged(string propertyName)
Parameters
propertyName
The name of the property that changed.
Overrides
OnTextChanged(EventArgs)
Raises the TextChanged event.
Declaration
protected override void OnTextChanged(EventArgs e)
Parameters
e
An EventArgs that contains the event data.
Overrides
ProcessMnemonic(char)
Processes a mnemonic character and activates the next control in the tab order.
ResetBackColorThemeOverrides()
Resets the background color theme overrides for the label element.
Declaration
protected override void ResetBackColorThemeOverrides()
Overrides
ResetForeColorThemeOverrides()
Resets the fore color theme overrides for the label element.
Declaration
protected override void ResetForeColorThemeOverrides()
Overrides
SetBackColorThemeOverrides()
Sets the background color theme overrides for the label element.
Declaration
protected override void SetBackColorThemeOverrides()
Overrides
SetForeColorThemeOverrides()
Sets the fore color theme overrides for the label element.
Declaration
protected override void SetForeColorThemeOverrides()
Overrides
ShouldSerializeChildProperty(RadProperty, RadObject)
Declaration
public override bool ShouldSerializeChildProperty(RadProperty property, RadObject element)
Parameters
property
element
Returns
Overrides
WndProc(ref Message)
Processes Windows messages sent to the control.
Declaration
protected override void WndProc(ref Message m)
Parameters
m
The Windows message to process.
Overrides