ChoiceActionBase Class

Represents the ancestor for Actions that provide items to be chosen by an end-user.

Namespace: DevExpress.ExpressApp.Actions

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#
VB.NET

public abstract class ChoiceActionBase :
    ActionBase,
    IComplexChoiceAction

Public MustInherit Class ChoiceActionBase
    Inherits ActionBase
    Implements IComplexChoiceAction

Remarks

Currently, the ChoiceActionBase class has a single descendant - the SingleChoiceAction. This descendant allows end-users to select a single item in the ChoiceActionBase.Items collection. This collection is provided by the ChoiceActionBase class. Each collection item can have child items as well. So, you can form a tree within this collection.

You can specify how to display a Choice Action, if its Items collection is empty. For instance, this Action can be disabled or made invisible (see ChoiceActionBase.EmptyItemsBehavior).

You can specify whether to execute a Choice Action when clicking it, or show its drop-down with items (see ChoiceActionBase.ShowItemsOnClick). To specify the Choice Action Item that is executed by default, use the ChoiceActionBase.DefaultItemMode property. You can set whether to always execute the first active item in Items collection or to execute the previously executed item.