Skip to main content
BuyLog In
XAF: Cross-Platform .NET App UI & Web API
Search in…
Docs > User Interface and Behavior Customization > Controllers and Actions > Actions (Menu Commands) > How to: Reorder an Action Container's Actions Collection
All docs
V24.1
.NET 6.0+
XAF: Cross-Platform .NET App UI & Web API
Getting Started
Installation, Upgrade, Version History
Backend Web API Service
UI Shell and Base Infrastructure
Storage, ORM, and Business Model Design
Data Manipulation and Business Logic
User Interface and Behavior Customization
Application Model (UI Settings Storage)
UI Element Overview
How to: Include a Custom UI Control That Is Not Integrated by Default
Controllers and Actions
Built-in Controllers and Actions (Menu Commands)
Controllers (UI Logic & Interaction)
Actions (Menu Commands)
Perform Common Tasks With XAF Actions
Access Actions in Different UI Areas
How to: Customize Action Controls
How to: Create an Action Using the Action Attribute
How to: Add a Search Action to Lookup Property Editors and Link Pop-up Windows
How to: Add the Analyze Action to List Views
How to: Add a Grid Column with an Action (ASP.NET Core Blazor and ASP.NET Web Forms)
How to: Customize the New Action's Items List
Ways to Hide or Disable an Action
Hide or Disable an Action (Button, Menu Item) in Code
How to: Disable an Action When the Current View Has Unsaved Changes
How to: Hide the Edit Action Column from a ListView in an ASP.NET Web Forms Application
How to: Initialize an Object Created Using the New Action
How to: Limit the Amount of Objects Created using the New Action
How to: Reorder an Action Container's Actions Collection
How to: Replace a List View's Default Action
How to: Place an Action in a Different Location
How to: Modify Action Properties in the Model Editor
Customize Controllers and Actions
Add Actions to a Pop-up Window
Dialog Controller
Logon Form Controllers and Actions
Determine Why an Action, Controller or Editor is Inactive
Define the Scope of Controllers and Actions
Determine an Action's Controller and Identifier
Windows and Frames
Templates
Action Containers
Views
View Items and Property Editors
List Editors
Ways to Access UI Elements and Their Controls
Data Filtering
Application Security and Data Safety
Multi-Tenancy (Data per Tenant)
Validation (Prevent Data Errors)
Conditional Appearance (Manage State of UI Elements)
Reporting (Shape, Export & Print Data)
Analytics (Extract Data Insights)
Document Management
Business Process Management
Event Planning
Localization
Accessibility Support
Debugging, Testing and Error Handling
Deployment
Support, QA & Troubleshooting
API Reference
Download CHM

How to: Reorder an Action Container's Actions Collection

  • 2 minutes to read

In an XAF application UI, Actions are located within Action Containers. You can use the ActionBase.Category property and the Application Model’s ActionDesign | ActionToContainerMapping node to move the Action to another Action Container (see How to: Place an Action in a Different Location). This topic describes how to reorder Actions within a specific container.

Presume you have the MyAction Action implemented in the MyController Controller. The ActionBase.Category property is set to View for this Action. This means that the Action is displayed within the View Action Container. This Container may also contain other Actions - custom Actions, and actions from referenced modules. To reorder Actions of the View Action Container (or any other Action Container), invoke the Model Editor for the WinForms, ASP.NET Web Forms or ASP.NET Core Blazor application project. Locate the ActionDesign | ActionToContainerMapping | View node. The following image shows that there are three Actions in the View Action Container.

PlaceActionToPosition_InitialSate

To reorder these Actions, change the Index property for each Action. For instance, use the “0” value for MyAction, “1” - for Refresh, “2” - for ExecuteReport.

PlaceActionToPosition_Index

If you run the application, you can ensure that the Actions order is changed as follows.

PlaceActionToPosition_Runtime

Note

  • Actions from the Unspecified Action Container can be displayed by another container if you change the IFrameTemplate.DefaultContainer value for the current Template. These Actions are appended to the end of the collection. If you need to change their position within the Container, then first specify their Action Container explicitly.
  • In the application with the TabbedMDI UI type (see MdiShowViewStrategy), the main window’s Actions collection is merged with the child window’s Actions, which can influence the resulting Actions order.

Tip

To change Action Containers order and location, customize the Template. In WinForms applications, you can also use the runtime customization capabilities.

See Also