SingleChoiceAction Class
Represents a Single Choice Action.
Namespace: DevExpress.ExpressApp.Actions
Assembly: DevExpress.ExpressApp.v21.1.dll
NuGet Package: DevExpress.ExpressApp
Declaration
Related API Members
The following members return SingleChoiceAction objects:
Remarks
The SingleChoiceAction class inherits both the basic functionality of Actions from the ActionBase class, and the functionality of Choice Actions - from the ChoiceActionBase class. Single Choice Actions are used to execute custom code when an end-user selects an item from the ChoiceActionBase.Items collection. You can populate this collection at design time via the Properties window. Select the Items property and click the ellipsis button provided for it. In the invoked ChoiceActionItems Collection Editor, add items and specify their settings.
Note
Each item within the ChoiceActionBase.Items collection can contain child items as well. So, you can form a tree of items for a Single Choice Action. You can specify the type of a Single Choice Action’s items: they can represent either modes or operations. To do this, use the SingleChoiceAction.ItemType property.
To provide custom code to be executed when users select a single item within the Items collection, handle the SingleChoiceAction.Execute event. To access the selected item, use the handler’s SingleChoiceActionExecuteEventArgs.SelectedChoiceActionItem parameter.
To add a Single Choice Action to a Controller, drag and drop the SingleChoiceAction item from the Toolbox (the XAF Actions section) onto the Controller’s Designer area (see Add an Action with Option Selection).
Set the IModelActionWeb.IsPostBackRequired property to true to send a postback when a user executes an Action in an ASP.NET Web Forms application. For example, for Actions that download files or change the application’s language.