RadMenu

Enabling the auto-scroll when there is very little available space can lead to a situation where only the scroll arrows are visible.
If the available space is lower than the specified value, the menu will attempt to screen boundary detection first (if enabled).

Enabling the auto-scroll when there is very little available space can lead to a situation where only the scroll arrows are visible.

If the available space is lower than the specified value, the menu will attempt to screen boundary detection first (if enabled).

Use the ClickToOpen property to customize the way root menu items are opened. By default menu items are opened on mouse hovering.

You can use the ClientChanges property to respond to client-side modifications such as

• adding a new item
• removing existing item
• clearing the children of an item or the control itself
• changing a property of the item

The ClientChanges property is available in the first postback (ajax) request after the client-side modifications have taken place. After this moment the property will return empty list.

Use the CollapseAnimation property to customize the expand animation of RadMenu. You can specify the Type, Duration and the items are collapsed.
To disable expand animation effects you should set the Type to AnimationType.None. To customize the expand animation you can use the ExpandAnimation property.

Use the CollapseDelay property to delay item closing. To cause immediate item closing set this property to 0 (zero).

To customize the timeout prior to item closing use the ExpandDelay property.

You can customize the following settings

• item flow
• expand direction
• horizontal offset from the parent item
• vertical offset from the parent item
• width
• height

For more information check RadMenuItemGroupSettings.

The overlay is an iframe element that is used to hide select and other elements from overlapping the menu.

By default RadMenu will check if there is enough space to open a menu item. If there isn't the expand direction of the item will be inverted - Left to Right, Bottom to Top and vice versa.

By default RadMenu will not apply a html encoding when the menu items are rendered.

Use the ExpandAnimation property to customize the expand animation of RadMenu. You can specify the Type and the Duration of the expand animation. To disable expand animation effects you should set the Type to AnimationType.None.
To customize the collapse animation you can use the CollapseAnimation property.

Use the ExpandDelay property to delay item opening.

To customize the timeout prior to item closing use the CollapseDelay property.

Use the Flow property to customize the way top level items are displayed. If set to Horizontal items are positioned one after another. Vertical causes the items to flow one below the other.

Use the Items property to access the root items of the RadMenu control. You can also use the Items property to manage the root items - you can add, remove or modify items.

When binding the RadMenu control to a data source, use the MaxDataBindDepth property to limit the number of levels to bind to the control. For example, setting this property to 2 binds only the root menu items and their immediate children. All remaining records in the data source are ignored.

If specified, the OnClientItemBlur client-side event handler is called when a menu item loses focus as a result of the user pressing a key or clicking elsewhere on the page. Two parameters are passed to the handler:

• sender, the menu client object;
• eventArgs with two properties, get_item() (the instance of the menu item) and get_domEvent (a reference to the browser event).

This event cannot be cancelled.

This event is similar to OnClientItemFocus but fires only on mouse click.

If specified, the OnClientItemClicked client-side event handler is called after a menu item is clicked upon. Two parameters are passed to the handler:

• sender, the menu client object;
• eventArgs with two properties, get_item() (the instance of the menu item) and get_domEvent (a reference to the browser event).

This event cannot be cancelled.

This event is similar to OnClientItemFocus but fires only on mouse click.

If specified, the OnClientItemClicking client-side event handler is called before a menu item is clicked upon. Two parameters are passed to the handler:

• sender, the menu client object;
• eventArgs with three properties, get_item() (the instance of the menu item), get_cancel()/set_cancel() - indicating if the event should be cancelled and get_domEvent (a reference to the browser event).

The OnClientItemClicking event can be cancelled. To do so, return False from the event handler.

If specified, the OnClientItemClosed client-side event handler is called when a group of child items closes. Two parameters are passed to the handler:

• sender, the menu client object;
• eventArgs with two properties, get_item() (the instance of the menu item) and get_domEvent (a reference to the browser event).

This event cannot be cancelled.

If specified, the OnClientItemClosing client-side event handler is called when a group of child items closes. Two parameters are passed to the handler:

• sender, the menu client object;
• eventArgs with three properties, get_item() (the instance of the menu item), get_cancel()/set_cancel() - indicating if the event should be cancelled and get_domEvent (a reference to the browser event).

This event can be cancelled.

If specified, the OnClientItemFocus client-side event handler is called when a menu item is selected using either the keyboard (the [TAB] or arrow keys) or by clicking it. Two parameters are passed to the handler:

• sender, the menu client object;
• eventArgs with two properties, get_item() (the instance of the menu item) and get_domEvent (a reference to the browser event).

This event cannot be cancelled.

If specified, the OnClientItemPopulated client-side event handler is called when a menu item children were just populated. Two parameters are passed to the handler:

• sender, the menu client object;
• eventArgs with one property:
  • get_item(), the instance of the menu item.

This event cannot be cancelled.

If specified, the OnClientItemPopulating client-side event handler is called when a menu item children are about to be populated. Two parameters are passed to the handler:

• sender, the menu client object;
• eventArgs with three properties:
  • get_item(), the instance of the menu item.
  • get_context(), an user object that will be passed to the web service.
  • set_cancel(), used to cancel the event.

This event can be cancelled.

If specified, the OnClientItemPopulationFailed client-side event handler is called when the operation to populate the children of a menu item has failed. Two parameters are passed to the handler:

• sender, the menu client object;
• eventArgs with two properties:
  • get_item(), the instance of the menu item.
  • set_cancel(), set to true to suppress the default action (alert message).

This event can be cancelled.

If specified, the OnClienLoad client-side event handler is called after the menu is fully initialized on the client.

A single parameter - the menu client object - is passed to the handler.

This event cannot be cancelled.

If specified, the OnClientMouseOut client-side event handler is called when the mouse moves out of a menu item. Two parameters are passed to the handler:

• sender, the menu client object;
• eventArgs with two properties, get_item() (the instance of the menu item) and get_domEvent (a reference to the browser event).

This event cannot be cancelled.

If specified, the OnClientMouseOver client-side event handler is called when the mouse moves over a menu item. Two parameters are passed to the handler:

• sender, the menu client object;
• eventArgs with two properties, get_item() (the instance of the menu item) and get_domEvent (a reference to the browser event).

This event cannot be cancelled.

The user can select a item by clicking on it. Use the SelectedItem property to determine which node is selected in the RadMenu control.

An item cannot be selected when it's configured to navigate to a given location.

By default RadMenu will not render toggle button for the item with children.

Use the WebServiceSettings property to configure the web service used to populate items on demand. You must specify both Path and Method to fully describe the service.

You can use the LoadingStatusTemplate property to create a loading template.

In order to use the integrated support, the web service should have the following signature:

   <pre><code class="lang-csharp">[ScriptService]

public class WebServiceName : WebService { [WebMethod] public RadMenuItemData[] WebServiceMethodName(RadMenuItemData item, object context) { // We cannot use a dictionary as a parameter, because it is only supported by script services. // The context object should be cast to a dictionary at runtime. IDictionary<string, object> contextDictionary = (IDictionary<string, object>) context;

    //...
}

}

The Predicate <> that defines the conditions of the element to search for.

The value to search for.

A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison).

The method returns the first item matching the search criteria. If no item is matching then null (Nothing in VB.NET) is returned.

The value to search for.

The method returns the first item matching the search criteria. If no item is matching then null (Nothing in VB.NET) is returned.

The value to search for.

The method returns the first Item matching the search criteria. If no Item is matching then null (Nothing in VB.NET) is returned.

The value to search for.

A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison).

The method returns the first item matching the search criteria. If no item is matching then null (Nothing in VB.NET) is returned.

The value to search for.

The method returns the first item matching the search criteria. If no item is matching then null (Nothing in VB.NET) is returned.

Use the GetAllItems method to obtain a linear collection of all items regardless their place in the hierarchy.

The name of the XML file.

The newly added items will be appended after any existing ones.

The menu will also postback if you navigate to a menu item using the [menu item] key and then press [enter] on the menu item that is focused. The instance of the clicked menu item is passed to the MenuItemClick event handler - you can obtain a reference to it using the eventArgs.RadMenuItem property.

The ItemCreated event is raised every time a new item is added.

The ItemCreated event is not related to data binding and you cannot retrieve the DataItem of the item in the event handler.

The ItemCreated event is often useful in scenarios where you want to initialize all items - for example setting the ToolTip of each RadMenuItem to be equal to the Text property.

The ItemDataBound event is raised for each menu item upon databinding. You can retrieve the item being bound using the event arguments. The DataItem associated with the item can be retrieved using the DataItem property.

The ItemDataBound event is often used in scenarios when you want to perform additional mapping of fields from the DataItem to their respective properties in the RadMenuItem class.