Class

RadLabelElement

Declaration

public RadLabelElement()

Identifies the BorderVisible dependency property that controls border visibility.

Declaration

public static RadProperty BorderVisibleProperty

Field Value

Identifies the DisplayStyle dependency property.

Declaration

public static RadProperty DisplayStyleProperty

Field Value

Identifies the ImageAlignment dependency property that controls image positioning within the element.

Declaration

public static RadProperty ImageAlignmentProperty

Field Value

Identifies the ImageIndex dependency property.

Declaration

public static RadProperty ImageIndexProperty

Field Value

Identifies the ImageKey dependency property.

Declaration

public static RadProperty ImageKeyProperty

Field Value

Identifies the Image dependency property for raster image content.

Declaration

public static RadProperty ImageProperty

Field Value

Identifies the SvgImage dependency property for vector image content.

Declaration

public static RadProperty SvgImageProperty

Field Value

Identifies the TextAlignment dependency property that controls text positioning within the element.

Declaration

public static RadProperty TextAlignmentProperty

Field Value

Identifies the TextImageRelation dependency property that defines the spatial relationship between text and image elements.

Declaration

public static RadProperty TextImageRelationProperty

Field Value

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

Declaration

public bool BorderVisible { get; set; }

Property Value

Gets or sets the raster image that is displayed in the label element.

Declaration

[TypeConverter(typeof(ImageTypeConverter))]
public virtual Image Image { get; set; }

Property Value

Gets or sets the alignment of image content within the label element's boundaries.

Declaration

public virtual ContentAlignment ImageAlignment { get; set; }

Property Value

Gets or sets the image list index value of the image displayed in the label element.

Declaration

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

Property Value

Gets or sets the key accessor for the image in the associated ImageList.

Declaration

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

Property Value

Gets the border primitive element responsible for rendering the border around the label.

Declaration

public BorderPrimitive LabelBorder { get; }

Property Value

Gets the fill primitive element responsible for painting the background fill of the label.

Declaration

public FillPrimitive LabelFill { get; }

Property Value

Gets the image primitive element responsible for rendering the image of the label.

Declaration

public ImagePrimitive LabelImage { get; }

Property Value

Gets the text primitive element responsible for rendering the text in the label.

Declaration

public TextPrimitive LabelText { get; }

Property Value

Gets or sets the vector image that is displayed in the label element.

Declaration

public RadSvgImage SvgImage { get; set; }

Property Value

Gets or sets the alignment of text content within the label element's boundaries.

Declaration

public virtual ContentAlignment TextAlignment { get; set; }

Property Value

Gets or sets the spatial relationship between text and image content within the label element.

Declaration

public virtual TextImageRelation TextImageRelation { get; set; }

Property Value

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

Declaration

public bool TextWrap { get; set; }

Property Value

Gets or sets a value indicating whether the text can contain keyboard mnemonics indicated by an ampersand character.

Declaration

public bool UseMnemonic { get; set; }

Property Value

Creates the child elements that comprise the label including border, fill, text, and image primitives.

Declaration

protected override void CreateChildElements()

Overrides RadElement.CreateChildElements()

Measures the desired size of the label element within the specified available size constraints.

Declaration

protected override SizeF MeasureOverride(SizeF availableSize)

Parameters

Returns

Overrides RadElement.MeasureOverride(SizeF)

Handles property changes and updates related elements accordingly.

Declaration

protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)

Parameters

Overrides RadItem.OnPropertyChanged(RadPropertyChangedEventArgs)

Determines whether the specified property should be serialized based on its value source and current state.

Declaration

public override bool? ShouldSerializeProperty(PropertyDescriptor property)

Parameters

Returns

Overrides RadItem.ShouldSerializeProperty(PropertyDescriptor)