Skip to main content
.NET 6.0+

ListEditor.ContextMenuTemplate Property

Provides access to a List Editor‘s Context Menu Template.

Namespace: DevExpress.ExpressApp.Editors

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp


public virtual IContextMenuTemplate ContextMenuTemplate { get; }

Property Value

Type Description

A control that implements the IContextMenuTemplate interface and represents a List Editor’s Context Menu Template.


A List Editor can show a context menu that contains a set of Actions:


The context menu can be represented by any control. However, it must implement the IContextMenuTemplate interface to display Actions. This interface includes the following members:

  • The IContextMenuTemplate.CreateActionItems method.

    This method receives a list of Action Containers as a parameter. Each Action Container creates controls for Actions that are mapped to it in the Application Model‘s ActionDesign | ActionToContainerMapping node.

  • The IContextMenuTemplate.BoundItemCreating event.

    The event is raised when XAF creates an Action in an Action Container. ActionsCriteriaViewController uses the event to determine the Action’s availability in the current context. If the Action’s availability conditions are satisfied, ActionsCriteriaViewController sets the event argument’s BoundItemCreatingEventArgs.Enabled property to true.

In the List Editor’s constructor, create a control that implements the IContextMenuTemplate interface and assign this control to the ContextMenuTemplate property.

The list of the Action Containers to be added to the List Editor’s Context Menu Template is specified by the Template of the active Window or Frame.

To change the Context Menu Template’s list of Action Containers, modify the corresponding Template.

For example, the following code snippet demonstrates a part of the MainForm.Designer.cs file. The following lines specify Action Containers for Context Menu Templates:


There are two ways to assign an Action to an Action Container:

  • Use an Action’s ActionBase.Category property. This property specifies the Action Container where the Action is assigned:


    If this property is not set, the Action is assigned to the Action Container used by default in a Template. Different Templates may have different default Action Containers. Depending on the current Template, the Action may be displayed in different Action Containers.

  • Use the Model Editor. Each child node of the ActionToContainerMapping node corresponds to an Action Container and contains a list of assigned Actions (their Category property specifies the Action Container’s name):


The following table lists XAF’s built-in Context Menu Templates:

Platform Name List Editor Description
ASP.NET Core Blazor ListEditorContextMenuTemplate DxGridListEditor Allows you to customize inline Actions with the help of the IContextMenuTemplate.BoundItemCreating event.
Windows Forms ActionsDXPopupMenu Built-in Windows Forms List Editors Creates a pop-up menu with an item for each Action.
ASP.NET Web Forms ASPxGridViewContextMenu ASPxGridListEditor Creates an additional grid column for each Action.
ASP.NET Web Forms ASPxSchedulerContextMenu SchedulerListEditor. Creates a pop-up menu with an item for each Action.

When you inherit from the ListEditor class, override the ContextMenuTemplate property to obtain the required Context Menu Template. For an example, refer to the following topic: How to: Support a Context Menu for a Custom Windows Forms List Editor.

See Also