MenuItem.SubMenuTemplate Property

Gets or sets a template used for displaying the client region’s content of the current menu item’s submenus.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v21.2.dll


public virtual ITemplate SubMenuTemplate { get; set; }

Property Value

Type Default Description


An object supporting the System.Web.UI.ITemplate interface which contains the template used for displaying the client regions of all submenus of the current menu item.


Use the SubMenuTemplate property to define the common content for the client regions of all submenus of the current menu item. A submenu’s client region is considered as an area where menu items are displayed - it involves the menu items, separators and gutters. The template created using the SubMenuTemplate property fills the entire client region of each submenu of the menu item.

The SubMenuTemplate property is useful when it is required to display a specific control within a particular menu item’s submenus. Placing a control onto the template container causes the control be displayed within a submenu when the submenu is invoked.

Note that any style settings defined for the client regions of the submenus via specific properties (such as the ASPxMenuBase.SubMenuStyle or MenuItem.SubMenuStyle) are still in effect for the submenus whose contents are specified using the SubMenuTemplate property.

The client region’s content of all submenus within a menu control can be defined using the menu’s ASPxMenuBase.SubMenuTemplate property.


Once a template defined via the SubMenuTemplate property is created within a tab control, it is instantiated within a container object of the MenuItemTemplateContainer type. This container object exposes a set of specific properties to which the template’