New to Telerik UI for WinForms? Start a free 30-day trial

RadMenuHeaderItem

Class

Represents a non-interactive header item within a RadDropDownMenu that displays text and images to provide visual grouping and organization of menu content without supporting selection or user interaction.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

public class RadMenuHeaderItem : RadMenuItemBase, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IButtonControl, IImageElement, IHierarchicalItem, IItemsOwner, ISiteProvider

Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRadButtonItemRadMenuItemBaseRadMenuHeaderItem...

Implements: IBindableComponentIButtonControlIComponentICustomTypeDescriptorIDisposableIHierarchicalItemIImageElementIItemsOwnerINotifyPropertyChangedIShortcutProviderISiteProviderIStylableElementIStylableNodeISupportDragISupportDropISupportSystemSkin...

Constructors

RadMenuHeaderItem()

Initializes a new instance of the RadMenuHeaderItem class with empty text.

public RadMenuHeaderItem()

RadMenuHeaderItem(string)

Initializes a new instance of the RadMenuHeaderItem class with the specified text.

public RadMenuHeaderItem(string text)

Parameters:textstring

The text to display in the header item.

Properties

BorderPrimitive

Gets the BorderPrimitive of this RadMenuHeaderItem.

[Browsable(true)]
public BorderPrimitive BorderPrimitive { get; }

FillPrimitive

Gets the FillPrimitive of this RadMenuHeaderItem.

[Browsable(true)]
public FillPrimitive FillPrimitive { get; }

ImageIndex

int

Gets or sets the index value of the image that is displayed on the item.

[Browsable(true)]
[RelatedImageList("MenuElement.ElementTree.Control.ImageList")]
public override int ImageIndex { get; set; }

Overrides: RadButtonItem.ImageIndex

ImageKey

string

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

[Browsable(true)]
[RelatedImageList("MenuElement.ElementTree.Control.ImageList")]
public override string ImageKey { get; set; }

Overrides: RadButtonItem.ImageKey

ImagePrimitive

Gets the ImagePrimitive of this RadMenuHeaderItem.

[Browsable(true)]
public ImagePrimitive ImagePrimitive { get; }

Selectable

bool

Gets a value indicating whether this RadMenuHeaderItem can be selected. Always returns false since header items are non-interactive.

public override bool Selectable { get; }

Property Value:

Always false for header items.

Overrides: RadItem.Selectable

TextPrimitive

Gets the TextPrimitive of this RadMenuHeaderItem.

[Browsable(true)]
public TextPrimitive TextPrimitive { get; }

Methods

ArrangeOverride(SizeF)

Arranges the child elements within the specified final size, positioning image and text elements according to menu layout constraints and RTL support.

protected override SizeF ArrangeOverride(SizeF finalSize)

Parameters:finalSizeSizeF

The final area within which this element should arrange itself and its children.

Returns:

SizeF

The actual size used by this element after arrangement.

Overrides: RadElement.ArrangeOverride(SizeF)

CreateChildElements()

Creates the child elements that comprise the visual structure of the RadMenuHeaderItem. Initializes fill, border, image, and text primitives with proper bindings and layout settings.

protected override void CreateChildElements()

Overrides: RadElement.CreateChildElements()

InitializeFields()

Initializes the fields and properties specific to the RadMenuHeaderItem. Sets the class name and disables mouse input handling for the header.

protected override void InitializeFields()

Overrides: RadMenuItemBase.InitializeFields()

ShouldSerializeProperty(PropertyDescriptor)

Determines whether the specified property should be serialized during design-time or persistence operations. Customizes serialization behavior for the Class property.

public override bool? ShouldSerializeProperty(PropertyDescriptor property)

Parameters:propertyPropertyDescriptor

The property descriptor to check for serialization.

Returns:

bool?

True if the property should be serialized; false if it should use default value; null for default behavior.

Overrides: RadMenuItemBase.ShouldSerializeProperty(PropertyDescriptor)