New to Telerik UI for WinFormsStart a free 30-day trial

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:

C#
[DefaultBindingProperty("Text")]
public class RadLabel : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider, ISupportRootUIAutomation

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadLabel...

Implements: IAnalyticsProviderIBindableComponentIComponentIComponentTreeHandlerIDisposableIDropTargetILayoutHandlerINotifyPropertyChangedISupportInitializeISupportInitializeNotificationISupportRootUIAutomationISynchronizeInvokeIWin32Window...

Inherited Members RadControl.isResizing2RadControl.isDisposing2RadControl.invalidResizeRectRadControl.isAccessibilityRequestedRadControl.Dispose(bool)RadControl.Construct()RadControl.CreateBehavior()RadControl.InitializeRootElement(RootRadElement)RadControl.LoadElementTree()RadControl.LoadElementTree(Size)RadControl.OnKeyDown(KeyEventArgs)RadControl.OnKeyUp(KeyEventArgs)RadControl.OnPreviewKeyDown(PreviewKeyDownEventArgs)RadControl.OnKeyPress(KeyPressEventArgs)RadControl.OnClick(EventArgs)RadControl.OnDoubleClick(EventArgs)RadControl.OnMouseDown(MouseEventArgs)RadControl.OnMouseUp(MouseEventArgs)RadControl.OnMouseEnter(EventArgs)RadControl.OnMouseLeave(EventArgs)RadControl.OnMouseMove(MouseEventArgs)RadControl.OnMouseHover(EventArgs)RadControl.OnMouseWheel(MouseEventArgs)RadControl.OnMouseCaptureChanged(EventArgs)RadControl.OnGotFocus(EventArgs)RadControl.OnLostFocus(EventArgs)RadControl.OnCreateControl()RadControl.OnHandleDestroyed(EventArgs)RadControl.OnParentChanged(EventArgs)RadControl.OnVisibleChanged(EventArgs)RadControl.OnFontChanged(EventArgs)RadControl.OnForeColorChanged(EventArgs)RadControl.OnBackColorChanged(EventArgs)RadControl.OnEnabledChanged(EventArgs)RadControl.OnBindingContextChanged(EventArgs)RadControl.OnLocationChanged(EventArgs)RadControl.OnPaddingChanged(EventArgs)RadControl.OnRightToLeftChanged(EventArgs)RadControl.OnPaint(PaintEventArgs)RadControl.OnLayout(LayoutEventArgs)RadControl.OnAutoSizeChanged(EventArgs)RadControl.OnInvalidated(RadElement)RadControl.OnLoad(Size)RadControl.OnCaptureLosing()RadControl.OnThemeChanged()RadControl.OnToolTipTextNeeded(object, ToolTipTextNeededEventArgs)RadControl.OnScreenTipNeeded(object, ScreenTipNeededEventArgs)RadControl.OnThemeNameChanged(ThemeNameChangedEventArgs)RadControl.ProcessFocusRequested(RadElement)RadControl.ProcessCaptureChangeRequested(RadElement, bool)RadControl.ProcessAutoSizeChanged(bool)RadControl.IsInputKey(Keys)RadControl.GetInputElement()RadControl.BeginInit()RadControl.EndInit()RadControl.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadControl.GetPreferredSize(Size)RadControl.SetBoundsCore(int, int, int, int, BoundsSpecified)RadControl.GetRootElementDesiredSize(int, int, int, int)RadControl.OnZoomGesture(ZoomGestureEventArgs)RadControl.OnRotateGesture(RotateGestureEventArgs)RadControl.OnPanGesture(PanGestureEventArgs)RadControl.OnTwoFingerTapGesture(GestureEventArgs)RadControl.OnPressAndTapGesture(PressAndTapGestureEventArgs)RadControl.OnGesture(GestureEventArgs)RadControl.ProcessGesture(Message)RadControl.EnableGesture(GestureType)RadControl.DisableGesture(GestureType)RadControl.Refresh()RadControl.SuspendUpdate()RadControl.ResumeUpdate()RadControl.ResumeUpdate(bool)RadControl.InvokeLayoutCallback(LayoutCallback)RadControl.RegisterHostedControl(RadHostItem)RadControl.UnregisterHostedControl(RadHostItem, bool)RadControl.ResolveStyleGroupForElement(StyleGroup, RadObject)RadControl.GetPlainText()RadControl.ShouldSerializeProperty(RadProperty)RadControl.ShouldSerializeProperty(RadProperty, RadObject)RadControl.ResetProperty(RadProperty, RadObject)RadControl.CanEditElementAtDesignTime(RadElement)RadControl.ProcessCodedUIMessage(ref IPCMessage)RadControl.FindPropertyInChildren(RadControl, IPCMessage)RadControl.ScaleControl(SizeF, BoundsSpecified)RadControl.PerformRadAutoScale(BoundsSpecified?)RadControl.GetMonitorDpiScaleFactor(Control)RadControl.SetRadAutoScale(bool)RadControl.EnableDpiScalingRadControl.EnableRadAutoScaleRadControl.EnableRadFormInitialDpiScalingRadControl.EnableImageDpiScalingRadControl.EnableSvgImagesRadControl.IsLoadedRadControl.ElementTreeRadControl.UseCompatibleTextRenderingDefaultValueRadControl.BehaviorRadControl.RootElementRadControl.PaddingRadControl.ThemeNameRadControl.TextRadControl.EnableThemingRadControl.ThemeClassNameRadControl.ImageListRadControl.ImageScalingSizeRadControl.UseCompatibleTextRenderingRadControl.MaximumSizeRadControl.MinimumSizeRadControl.FocusableRadControl.SiteRadControl.CausesValidationRadControl.IsInitializingRadControl.SmallImageListRadControl.SmallImageScalingSizeRadControl.IsDesignModeRadControl.IsDisplayedRadControl.FocusedElementRadControl.AllowShowFocusCuesRadControl.ShowItemToolTipsRadControl.CommandBindingsRadControl.EnableKeyMapRadControl.BackColorRadControl.ForeColorRadControl.FontRadControl.ValidationCancelRadControl.EnableAnalyticsRadControl.AnalyticsNameRadControl.EnableRadAccessibilityObjectsRadControl.EnableCodedUITestsRadControl.EnableCodedUITestsDefaultValueRadControl.EnableUIAutomationDefaultValueRadControl.ElementInvalidatedRadControl.ToolTipTextNeededRadControl.ScreenTipNeededRadControl.ThemeNameChangedRadControl.InitializedRadControl.PropertyChangedRadControl.ZoomGestureRadControl.RotateGestureRadControl.PanGestureRadControl.TwoFingerTapGestureRadControl.PressAndTapGesture...

Constructors

Initializes a new instance of the RadLabel class.

C#
public RadLabel()

Properties

Gets or sets a value indicating whether the control is automatically resized to display its entire contents.

C#
[Browsable(true)]
public override bool AutoSize { get; set; }

Overrides: RadControl.AutoSize

Gets or sets a value indicating whether the border is visible.

C#
public bool BorderVisible { get; set; }

Gets the default size of the control.

C#
protected override Size DefaultSize { get; }

Overrides: Control.DefaultSize

Gets or sets a value indicating whether UI Automation support is enabled for the label. Default value is true.

C#
public override bool EnableUIAutomation { get; set; }

Overrides: RadControl.EnableUIAutomation

Implements: ISupportRootUIAutomation.EnableUIAutomation

Gets or sets the image that is displayed on the label.

C#
public Image Image { get; set; }

Gets or sets the alignment of image content on the drawing surface.

C#
public ContentAlignment ImageAlignment { get; set; }

Gets or sets the image list index value of the image displayed on the label control.

C#
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.3.817.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
[RelatedImageList("ImageList")]
public int ImageIndex { get; set; }

Gets or sets the key accessor for the image in the label.

C#
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.3.817.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
[RelatedImageList("ImageList")]
public virtual string ImageKey { get; set; }

Gets the RadLabelElement that represents the visual element of this label control.

C#
[Browsable(false)]
public RadLabelElement LabelElement { get; }

Gets or sets the SVG image displayed on the label.

C#
public RadSvgImage SvgImage { get; set; }

Gets or sets the alignment of text content on the drawing surface.

C#
public ContentAlignment TextAlignment { get; set; }

Gets or sets the position of text and image relative to each other.

C#
public TextImageRelation TextImageRelation { get; set; }

Gets or sets a value indicating whether the text should wrap to the available layout rectangle.

C#
public bool TextWrap { get; set; }

Gets or sets a value indicating whether the first character preceded by an ampersand will be used as the label's mnemonic key.

C#
public bool UseMnemonic { get; set; }

Methods

Creates the RadLabelAccessibleObject instance for this control.

C#
protected override AccessibleObject CreateAccessibilityInstance()
Returns:

AccessibleObject

An AccessibleObject instance for this control.

Overrides: Control.CreateAccessibilityInstance()

Creates the child items within the specified parent element.

C#
protected override void CreateChildItems(RadElement parent)
Parameters:parentRadElement

The parent element that will contain the child items.

Overrides: RadControl.CreateChildItems(RadElement)

Creates the RadLabelElement for this control.

C#
protected virtual RadLabelElement CreateLabelElement()
Returns:

RadLabelElement

A new RadLabelElement instance.

Creates the root element for RadLabel control.

C#
protected override RootRadElement CreateRootElement()
Returns:

RootRadElement

A new RadLabelRootElement instance.

Overrides: RadControl.CreateRootElement()

Raises the NotifyPropertyChanged event for the specified property.

C#
protected override void OnNotifyPropertyChanged(string propertyName)
Parameters:propertyNamestring

The name of the property that changed.

Overrides: RadControl.OnNotifyPropertyChanged(string)

Raises the TextChanged event.

C#
protected override void OnTextChanged(EventArgs e)
Parameters:eEventArgs

An EventArgs that contains the event data.

Overrides: Control.OnTextChanged(EventArgs)

Processes a mnemonic character and activates the next control in the tab order.

C#
protected override bool ProcessMnemonic(char charCode)
Parameters:charCodechar

The character to process.

Returns:

bool

True if the character was processed as a mnemonic by the control; otherwise, false.

Overrides: RadControl.ProcessMnemonic(char)

Resets the background color theme overrides for the label element.

C#
protected override void ResetBackColorThemeOverrides()

Overrides: RadControl.ResetBackColorThemeOverrides()

Resets the fore color theme overrides for the label element.

C#
protected override void ResetForeColorThemeOverrides()

Overrides: RadControl.ResetForeColorThemeOverrides()

Sets the background color theme overrides for the label element.

C#
protected override void SetBackColorThemeOverrides()

Overrides: RadControl.SetBackColorThemeOverrides()

Sets the fore color theme overrides for the label element.

C#
protected override void SetForeColorThemeOverrides()

Overrides: RadControl.SetForeColorThemeOverrides()

C#
public override bool ShouldSerializeChildProperty(RadProperty property, RadObject element)
Parameters:propertyRadPropertyelementRadObjectReturns:

bool

Overrides: RadControl.ShouldSerializeChildProperty(RadProperty, RadObject)

Processes Windows messages sent to the control.

C#
protected override void WndProc(ref Message m)
Parameters:mMessage

The Windows message to process.

Overrides: RadControl.WndProc(ref Message)