[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Collapse]eXpressApp Framework
 [Expand]Fundamentals
 [Expand]Getting Started
 [Expand]Concepts
 [Expand]Design-Time Features
 [Expand]Deployment
 [Expand]Task-Based Help
  Frequently Asked Questions (FAQ)
 [Collapse]API Reference
  [Expand]DevExpress.EasyTest.Framework
  [Expand]DevExpress.ExpressApp
  [Collapse]DevExpress.ExpressApp.Actions
   [Expand]ActionBase Class
   [Expand]ActionBaseEventArgs Class
   [Expand]ActionBaseExtensions Class
    ActionMeaning Enumeration
   [Expand]ActionUrl Class
    ActiveItemsBehavior Enumeration
   [Expand]ChoiceActionBase Class
   [Collapse]ChoiceActionItem Class
     ChoiceActionItem Members
    [Expand]ChoiceActionItem Constructor
    [Expand]ChoiceActionItem Properties
    [Expand]ChoiceActionItem Methods
   [Expand]ChoiceActionItemCollection Class
    ChoiceActionItemFindTarget Enumeration
    ChoiceActionItemFindType Enumeration
   [Expand]CustomGetTotalTooltipEventArgs Class
   [Expand]CustomizeControlEventArgs Class
   [Expand]CustomizePopupWindowParamsEventArgs Class
    CustomizePopupWindowParamsEventHandler Delegate
    DefaultItemMode Enumeration
    EmptyItemsBehavior Enumeration
   [Expand]HandleExceptionEventArgs Class
    ImageMode Enumeration
   [Expand]ParametrizedAction Class
   [Expand]ParametrizedActionExecuteEventArgs Class
    ParametrizedActionExecuteEventHandler Delegate
   [Expand]PopupWindowShowAction Class
   [Expand]PopupWindowShowActionExecuteEventArgs Class
    PopupWindowShowActionExecuteEventHandler Delegate
    SelectionDependencyType Enumeration
   [Expand]SimpleAction Class
   [Expand]SimpleActionExecuteEventArgs Class
    SimpleActionExecuteEventHandler Delegate
   [Expand]SingleChoiceAction Class
   [Expand]SingleChoiceActionExecuteEventArgs Class
    SingleChoiceActionExecuteEventHandler Delegate
    SingleChoiceActionItemType Enumeration
   [Expand]SupportClientScriptsExtensions Class
    TargetObjectsCriteriaMode Enumeration
  [Expand]DevExpress.ExpressApp.AuditTrail
  [Expand]DevExpress.ExpressApp.Chart
  [Expand]DevExpress.ExpressApp.Chart.Web
  [Expand]DevExpress.ExpressApp.Chart.Win
  [Expand]DevExpress.ExpressApp.CloneObject
  [Expand]DevExpress.ExpressApp.ConditionalAppearance
  [Expand]DevExpress.ExpressApp.Dashboards
  [Expand]DevExpress.ExpressApp.Dashboards.Web
  [Expand]DevExpress.ExpressApp.Dashboards.Win
  [Expand]DevExpress.ExpressApp.Data
  [Expand]DevExpress.ExpressApp.DC
  [Expand]DevExpress.ExpressApp.DC.ClassGeneration
  [Expand]DevExpress.ExpressApp.Editors
  [Expand]DevExpress.ExpressApp.EF
  [Expand]DevExpress.ExpressApp.EF.Utils
  [Expand]DevExpress.ExpressApp.FileAttachments.Web
  [Expand]DevExpress.ExpressApp.FileAttachments.Win
  [Expand]DevExpress.ExpressApp.Filtering
  [Expand]DevExpress.ExpressApp.HtmlPropertyEditor.Web
  [Expand]DevExpress.ExpressApp.HtmlPropertyEditor.Win
  [Expand]DevExpress.ExpressApp.Kpi
  [Expand]DevExpress.ExpressApp.Layout
  [Expand]DevExpress.ExpressApp.Maps.Mobile
  [Expand]DevExpress.ExpressApp.Maps.Mobile.Editors
  [Expand]DevExpress.ExpressApp.Maps.Web
  [Expand]DevExpress.ExpressApp.Maps.Web.Helpers
  [Expand]DevExpress.ExpressApp.MiddleTier
  [Expand]DevExpress.ExpressApp.Mobile
  [Expand]DevExpress.ExpressApp.Mobile.Editors
  [Expand]DevExpress.ExpressApp.Mobile.MobileModel
  [Expand]DevExpress.ExpressApp.Mobile.SystemModule
  [Expand]DevExpress.ExpressApp.Mobile.Templates
  [Expand]DevExpress.ExpressApp.Model
  [Expand]DevExpress.ExpressApp.Model.Core
  [Expand]DevExpress.ExpressApp.Model.NodeGenerators
  [Expand]DevExpress.ExpressApp.ModelEditor
  [Expand]DevExpress.ExpressApp.Notifications
  [Expand]DevExpress.ExpressApp.Notifications.Web
  [Expand]DevExpress.ExpressApp.Notifications.Win
  [Expand]DevExpress.ExpressApp.Office.Win
  [Expand]DevExpress.ExpressApp.PivotChart
  [Expand]DevExpress.ExpressApp.PivotChart.Web
  [Expand]DevExpress.ExpressApp.PivotChart.Win
  [Expand]DevExpress.ExpressApp.PivotGrid
  [Expand]DevExpress.ExpressApp.PivotGrid.Web
  [Expand]DevExpress.ExpressApp.PivotGrid.Win
  [Expand]DevExpress.ExpressApp.Reports
  [Expand]DevExpress.ExpressApp.Reports.Web
  [Expand]DevExpress.ExpressApp.Reports.Win
  [Expand]DevExpress.ExpressApp.ReportsV2
  [Expand]DevExpress.ExpressApp.ReportsV2.Mobile
  [Expand]DevExpress.ExpressApp.ReportsV2.Web
  [Expand]DevExpress.ExpressApp.ReportsV2.Win
  [Expand]DevExpress.ExpressApp.Scheduler
  [Expand]DevExpress.ExpressApp.Scheduler.Web
  [Expand]DevExpress.ExpressApp.Scheduler.Win
  [Expand]DevExpress.ExpressApp.ScriptRecorder
  [Expand]DevExpress.ExpressApp.ScriptRecorder.Web
  [Expand]DevExpress.ExpressApp.ScriptRecorder.Win
  [Expand]DevExpress.ExpressApp.Security
  [Expand]DevExpress.ExpressApp.Security.Adapters
  [Expand]DevExpress.ExpressApp.Security.ClientServer.Wcf
  [Expand]DevExpress.ExpressApp.Security.EF.Adapters
  [Expand]DevExpress.ExpressApp.Security.Strategy
  [Expand]DevExpress.ExpressApp.Security.Xpo.Adapters
  [Expand]DevExpress.ExpressApp.StateMachine
  [Expand]DevExpress.ExpressApp.SystemModule
  [Expand]DevExpress.ExpressApp.Templates
  [Expand]DevExpress.ExpressApp.Templates.ActionContainers
  [Expand]DevExpress.ExpressApp.TreeListEditors
  [Expand]DevExpress.ExpressApp.TreeListEditors.Web
  [Expand]DevExpress.ExpressApp.TreeListEditors.Win
  [Expand]DevExpress.ExpressApp.Updating
  [Expand]DevExpress.ExpressApp.Utils
  [Expand]DevExpress.ExpressApp.Validation
  [Expand]DevExpress.ExpressApp.Validation.Web
  [Expand]DevExpress.ExpressApp.Validation.Win
  [Expand]DevExpress.ExpressApp.ViewVariantsModule
  [Expand]DevExpress.ExpressApp.Web
  [Expand]DevExpress.ExpressApp.Web.Controls
  [Expand]DevExpress.ExpressApp.Web.Editors
  [Expand]DevExpress.ExpressApp.Web.Editors.ASPx
  [Expand]DevExpress.ExpressApp.Web.SystemModule
  [Expand]DevExpress.ExpressApp.Web.Templates
  [Expand]DevExpress.ExpressApp.Web.Utils
  [Expand]DevExpress.ExpressApp.Win
  [Expand]DevExpress.ExpressApp.Win.Core
  [Expand]DevExpress.ExpressApp.Win.Editors
  [Expand]DevExpress.ExpressApp.Win.Model
  [Expand]DevExpress.ExpressApp.Win.SystemModule
  [Expand]DevExpress.ExpressApp.Win.Templates
  [Expand]DevExpress.ExpressApp.Win.Templates.Navigation
  [Expand]DevExpress.ExpressApp.Win.Utils
  [Expand]DevExpress.ExpressApp.Workflow
  [Expand]DevExpress.ExpressApp.Workflow.Win
  [Expand]DevExpress.ExpressApp.Xpo
  [Expand]DevExpress.ExpressApp.Xpo.Utils
  [Expand]DevExpress.Persistent.Base
  [Expand]DevExpress.Persistent.Base.General
  [Expand]DevExpress.Persistent.Base.ReportsV2
  [Expand]DevExpress.Persistent.Base.Security
  [Expand]DevExpress.Persistent.BaseImpl
  [Expand]DevExpress.Persistent.BaseImpl.EF
  [Expand]DevExpress.Persistent.BaseImpl.EF.PermissionPolicy
  [Expand]DevExpress.Persistent.BaseImpl.PermissionPolicy
  [Expand]DevExpress.Persistent.Validation
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

ChoiceActionItem Class

An item of the SingleChoiceAction Action.

Namespace:DevExpress.ExpressApp.Actions
Assembly:DevExpress.ExpressApp.v19.1.dll

Expanded Syntax

Expanded Remarks

The eXpressApp Framework supplies the SingleChoiceAction which can be used to execute custom code when an end-user selects one of its items. These items are represented by the ChoiceActionItem class and contained in the ChoiceActionBase.Items collection. To add items to this collection, use the ellipsis button provided by the Single Choice Action's Items property in the Properties window. Via this button, you can invoke theChoiceActionItem Collection Editor, which allows you to specify settings of the collection's items.

A Choice Action Item can contain nested Items, which can contain Items as well. So, an Item can serve as a parent for a collection of items. This collection is accessed via the Items property. To populate this collection at design time, use the ChoiceActionItem Collection Editor.

In some scenarios, you can create Choice Action Items and add them to the ChoiceActionBase.Items collection of the required Single Choice Action in the Controller's constructor code. In the Main Demo, you can see an example where the created Choice Action Items represent an enumeration's values (see Add an Action with Option Selection). In this instance, they cannot be created at design time.

The Choice Action Items that are added to a Single Choice Action at design time or in the Controller's constructor are loaded to the Application Model. So, you can invoke the Model Editor and use the ActionDesign | Actions | Action | ChoiceActionItems node to set images, shortcuts and localized captions for the Choice Action Items of the required Action. However, there can be scenarios when you have to create Choice Action Items in the Controller's Controller.Activated event handler, because the Application, View and other objects are available when this event is raised. In this instance, the created items will not be loaded to the Application Model. You can see an example in the View.SetModel member description.

You can make a Choice Action Item enabled or disabled. For this purpose, use the Enabled method. To indicate whether the Item is currently enabled, use the same method in a conditional expression. Alternatively, use the BoolList.ResultValue property of the object returned by the Enabled property.

To associate a Choice Action Item with an object, use its Data property.

If you need to implement a Choice Action that differs from the SingleChoiceAction, you can use this class to present the Action's Items.

Expanded Inheritance Hierarchy

System.Object
    ChoiceActionItem

Expanded See Also

Is this topic helpful?​​​​​​​