SingleChoiceAction.SelectedItem Property

Specifies a Single Choice Action’s selected item.

Namespace: DevExpress.ExpressApp.Actions

Assembly: DevExpress.ExpressApp.v22.2.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

[Browsable(false)]
public ChoiceActionItem SelectedItem { get; set; }

VB.NET

<Browsable(False)>
Public Property SelectedItem As ChoiceActionItem

Property Value

Type	Description
ChoiceActionItem	A ChoiceActionItem object that represents the Single Choice Action’s item which is currently selected.

Remarks

Use this property to specify the Single Choice Action’s item which is displayed as a selected item in a UI. Manual changing of this property value raises the SingleChoiceAction.SelectedItemChanged event. However, when an end-user changes this value by selecting an item in the Action’s control, the SingleChoiceAction.Execute event is raised.

You may need to use this property and the corresponding event when implementing a custom Action Container.

Related GitHub Examples

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

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-save-and-share-custom-view-settings/CS/ViewSettingsSolution.Module/Controllers/ViewVariantsController.cs#L67

ChoiceActionItem itemToSelect = SelectViewVariantAction.Items.FindItemByID(itemToSelectCaption);
SelectViewVariantAction.SelectedItem = (itemToSelect != null) ? itemToSelect : defaultItem;
lastSelectedItem = SelectViewVariantAction.SelectedItem;

XAF_how-to-auto-select-the-first-item-when-changing-the-group-in-the-navigation-control-e506/CS/DXExample.Module/SelectFirstNavigationItemControllerBase.cs#L38

if (!CanAutoSelectFirstItemInGroup()) return;
if (navGroupItem.Items.Contains(navigationAction.SelectedItem)) return;
foreach (ChoiceActionItem item in navGroupItem.Items) {

XAF_how-to-customize-the-export-action-behavior-e2335/CS/CustomizeExportAction.Module.Win/Controllers/CustomizeExportControllerWin.cs#L71

       "{0} {1}", winExportController.ExportAction.Caption,
           winExportController.ExportAction.SelectedItem);
}

VB.NET

xaf-save-and-share-custom-view-settings/VB/ViewSettingsSolution.Module/Controllers/ViewVariantsController.vb#L84

Dim itemToSelect As ChoiceActionItem = SelectViewVariantAction.Items.FindItemByID(itemToSelectCaption)
SelectViewVariantAction.SelectedItem = If(itemToSelect IsNot Nothing, itemToSelect, defaultItem)
lastSelectedItem = SelectViewVariantAction.SelectedItem

XAF_how-to-auto-select-the-first-item-when-changing-the-group-in-the-navigation-control-e506/VB/DXExample.Module/SelectFirstNavigationItemControllerBase.vb#L42

End If
If navGroupItem.Items.Contains(navigationAction.SelectedItem)
    Return

XAF_how-to-customize-the-export-action-behavior-e2335/VB/CustomizeExportAction.Module.Win/Controllers/CustomizeExportControllerWin.vb#L67

Private Function GetMessageBoxCaption() As String
   Return String.Format("{0} {1}", winExportController.ExportAction.Caption, winExportController.ExportAction.SelectedItem)
End Function