SingleChoiceAction.Execute Event

Occurs when an end-user clicks the required item located in the Single Choice Action’s item list.

Namespace: DevExpress.ExpressApp.Actions

Assembly: DevExpress.ExpressApp.v19.2.dll

Declaration

C#

public event SingleChoiceActionExecuteEventHandler Execute

VB.NET

Public Event Execute As SingleChoiceActionExecuteEventHandler

Event Data

The Execute event's data class is SingleChoiceActionExecuteEventArgs. The following properties provide information specific to this event:

Property	Description
Action	Provides access to the Action being executed. Inherited from ActionBaseEventArgs.
CurrentObject	Provides access to the current object represented by the currently displayed View. Inherited from SimpleActionExecuteEventArgs.
SelectedChoiceActionItem	Provides access to a Single Choice Action’s selected item.
SelectedObjects	Provides access to the objects selected in the currently invoked View. Inherited from SimpleActionExecuteEventArgs.
ShowViewParameters	Provides access to the ShowViewParameters object, specifying a View, displayed after executing the current Action. Inherited from ActionBaseEventArgs.

Remarks

Handle this event to execute custom code when an end-user clicks an item located in the current Single Choice Action’s item list (see ChoiceActionBase.Items). To access this item, use the handler’s SingleChoiceActionExecuteEventArgs.SelectedChoiceActionItem parameter. If you need an additional View to be displayed after executing the Action, use the ActionBaseEventArgs.ShowViewParameters parameter to specify this View and its settings.

For additional information, refer to the How to: Access Objects Selected in the Current View help topic.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Execute event.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

XAF_how-to-use-criteria-property-editors-e932/CS/HowToUseCriteriaPropertyEditors.Module/CriteriaController.cs#L20

    this, "FilteringCriterion", PredefinedCategory.Filters);
filteringCriterionAction.Execute += new DevExpress.ExpressApp.Actions.SingleChoiceActionExecuteEventHandler(this.FilteringCriterionAction_Execute);
TargetViewType = ViewType.ListView;

XAF_how-to-save-and-share-custom-view-settings-t537863/CS/ViewSettingsSolution.Module/Controllers/ViewVariantsController.cs#L157

this.SelectViewVariantAction.PaintStyle = ActionItemPaintStyle.Caption;
this.SelectViewVariantAction.Execute += new SingleChoiceActionExecuteEventHandler(this.SelectViewVariantAction_Execute);

VB.NET

XAF_how-to-use-criteria-property-editors-e932/VB/HowToUseCriteriaPropertyEditors.Module/CriteriaController.vb#L21

filteringCriterionAction = New SingleChoiceAction(Me, "FilteringCriterion", PredefinedCategory.Filters)
AddHandler filteringCriterionAction.Execute, AddressOf FilteringCriterionAction_Execute
TargetViewType = ViewType.ListView

XAF_how-to-save-and-share-custom-view-settings-t537863/VB/ViewSettingsSolution.Module/Controllers/ViewVariantsController.vb#L158

Me.SelectViewVariantAction.PaintStyle = ActionItemPaintStyle.Caption
AddHandler SelectViewVariantAction.Execute, AddressOf SelectViewVariantAction_Execute