Class

RadMenuElement

Declaration

public RadMenuElement()

Identifies the AllItemsEqualHeight dependency property that controls whether all menu items have the same height.

Declaration

public static RadProperty AllItemsEqualHeightProperty

Field Value

Identifies the DropDownAnimationEasing dependency property that controls the easing type for dropdown animations.

Declaration

public static RadProperty DropDownAnimationEasingProperty

Field Value

Identifies the DropDownAnimationEnabled dependency property that controls whether dropdown animations are enabled.

Declaration

public static RadProperty DropDownAnimationEnabledProperty

Field Value

Identifies the DropDownAnimationFrames dependency property that controls the number of animation frames.

Declaration

public static RadProperty DropDownAnimationFramesProperty

Field Value

Identifies the Orientation dependency property that determines the layout direction of menu items.

Declaration

public static RadProperty OrientationProperty

Field Value

Gets or sets a value indicating whether all menu items will appear with the same height, using the height of the tallest item in the collection.

Declaration

[Browsable(true)]
public bool AllItemsEqualHeight { get; set; }

Property Value

Gets or sets a value indicating whether this menu allows merging with other RadMenuElement instances to create a unified menu structure.

Declaration

public bool AllowMerge { get; set; }

Property Value

Gets or sets the close button element that provides functionality to close the parent form when the menu is used as a title bar.

Declaration

public RadImageButtonElement CloseButton { get; set; }

Property Value

Gets or sets the context menu item that represents the currently active context for contextual menu operations.

Declaration

public RadMenuItemBase ContextItem { get; set; }

Property Value

Gets or sets the easing type used for dropdown animations when DropDownAnimationEnabled is true.

Declaration

[Browsable(true)]
public RadEasingType DropDownAnimationEasing { get; set; }

Property Value

Gets or sets a value indicating whether dropdown animations are enabled when submenu items are displayed.

Declaration

[Browsable(true)]
public bool DropDownAnimationEnabled { get; set; }

Property Value

Gets or sets the number of frames used for dropdown animations when DropDownAnimationEnabled is true.

Declaration

[Browsable(true)]
public int DropDownAnimationFrames { get; set; }

Property Value

Gets the collection of root menu items that are displayed in the menu. Root items are top-level menu items that have no parent item and can contain child items as submenus.

Declaration

[Browsable(true)]
[RadNewItem("Type here", true)]
public RadItemOwnerCollection Items { get; }

Property Value

Remarks

Gets an instance of the WrapLayoutPanel class that represents the layout panel responsible for arranging menu items within the menu.

Declaration

[Browsable(false)]
public WrapLayoutPanel ItemsLayout { get; }

Property Value

Gets or sets the maximize button element that provides functionality to maximize or restore the parent form when the menu is used as a title bar.

Declaration

public RadImageButtonElement MaximizeButton { get; set; }

Property Value

Gets an instance of the BorderPrimitive class that represents the border element of the menu.

Declaration

[Browsable(false)]
public BorderPrimitive MenuBorder { get; }

Property Value

Gets an instance of the FillPrimitive class that represents the background fill element of the menu.

Declaration

[Browsable(false)]
public FillPrimitive MenuFill { get; }

Property Value

Gets or sets the minimize button element that provides functionality to minimize the parent form when the menu is used as a title bar.

Declaration

public RadImageButtonElement MinimizeButton { get; set; }

Property Value

Gets or sets the Orientation of menu items, determining whether they are arranged horizontally or vertically.

Declaration

[Browsable(true)]
public Orientation Orientation { get; set; }

Property Value

Gets or sets the StackLayoutPanel that contains the system buttons (minimize, maximize, and close) used when the menu functions as a title bar.

Declaration

public StackLayoutPanel SystemButtons { get; set; }

Property Value

Arranges the child elements within the specified bounds, including proper positioning of system buttons.

Declaration

protected override SizeF ArrangeOverride(SizeF finalSize)

Parameters

Returns

Overrides RadElement.ArrangeOverride(SizeF)

Creates and initializes the child elements of the menu, including the layout panel, system buttons, fill, and border primitives.

Declaration

protected override void CreateChildElements()

Overrides RadElement.CreateChildElements()

Initializes the fields and collections used by the menu element, setting up the items collection and its properties.

Declaration

protected override void InitializeFields()

Overrides RadItem.InitializeFields()

Measures the size required by the menu element, including padding considerations.

Declaration

protected override SizeF MeasureOverride(SizeF availableSize)

Parameters

Returns

Overrides RadElement.MeasureOverride(SizeF)

Raises the AllItemsEqualHeightChanged event when the equal height setting for menu items changes.

Declaration

protected virtual void OnAllItemsEqualHeightChanged(EventArgs args)

Parameters

Raises the OrientationChanged event when the menu orientation changes.

Declaration

protected virtual void OnOrientationChanged(EventArgs args)

Parameters

Called when a property value changes. Handles orientation and equal height property changes to update the menu layout accordingly.

Declaration

protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)

Parameters

Overrides RadItem.OnPropertyChanged(RadPropertyChangedEventArgs)

Handles tunnel events from child elements, particularly auto-size change events for proper layout management.

Declaration

protected override void OnTunnelEvent(RadElement sender, RoutedEventArgs args)

Parameters

Overrides RadElement.OnTunnelEvent(RadElement, RoutedEventArgs)

Occurs when the AllItemsEqualHeight property value changes, indicating a change in the height uniformity setting for menu items.

Declaration

public event EventHandler AllItemsEqualHeightChanged

Event Value

Occurs when the Orientation property value changes, indicating a change in the layout direction of menu items.

Declaration

public event EventHandler OrientationChanged

Event Value