A newer version of this page is available. Switch to the current version.

How to: Include an Action to a Detail View Layout

  • 2 minutes to read

In specific scenarios, you may need to place an Action in a View and not a toolbar. In this case, you need to use an Action Container View Item. The Action Container View Item is used to display a particular Action Container in a UI. Use this approach when you need to place an Action on a Detail View or Dashboard View layout. To add a button to a Detail View, execute the following steps.


A complete sample project is available in the DevExpress Code Examples database at http://www.devexpress.com/example=E1847.

  • Create a Controller, add a Simple Action to it and handle the Action's Execute event. For a step-by-step guide, refer to the Add a Simple Action tutorial. When running the application, a button will be created to represent the Simple Action. The code implemented in the Execute event handler will be performed when an end-user clicks this button.
  • Create a new Action category by setting the ActionBase.Category to a custom value by selecting the current value text and typing a custom value. For instance, you can set the Action's category to "MyCategory". Rebuild your project.


  • Invoke the Model Editor for your platform-independent Module project and navigate to the required Views | DetailView node (if theModel Editor is already opened, restart it). Add a new ActionContainerViewItem child node to the Detail View's Items node via the context menu.


  • Set the newly created node's Id property to "MyActionContainer" and the ActionContainer property to "MyCategory".


  • Focus the Views | DetailView | Layout node. Right-click on an empty space to invoke the layout customization dialog, then place the newly-created control at the required location. For details on how to change the layout, refer to the View Items Layout Customization topic.


  • Run the application to make sure that the button is added to the required Detail View.


See Also