ChangeVariantController.ChangeVariantAction Property

Gets a SingleChoiceAction used to change View variants.

Namespace: DevExpress.ExpressApp.ViewVariantsModule

Assembly: DevExpress.ExpressApp.ViewVariantsModule.v25.2.dll

NuGet Package: DevExpress.ExpressApp.ViewVariantsModule

Declaration

C#

public SingleChoiceAction ChangeVariantAction { get; }

VB.NET

Public ReadOnly Property ChangeVariantAction As SingleChoiceAction

Property Value

Type	Description
SingleChoiceAction	A SingleChoiceAction object representing the Action used to change View variants.

Remarks

ChangeVariantAction is the SingleChoiceAction Action that allows users to select a View variant to be displayed within the current Window (Frame). This Action has the View caption and the ChangeVariant ID.

In a Windows Forms application:

Predefined items displayed in the drop-down list are specified by the Views | View | Variants node of the Application Model. The action is visible if there are two or more variants available for a current varied View. This action can be customized via the ActionDesign | Actions | View node.

To see why the ChangeVariant Action is currently deactivated or disabled, use the DiagnosticInfo Action. If you need to change the Action’s “active” or “enabled” state in code, use its ActionBase.Active or ActionBase.Enabled property, respectively.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ChangeVariantAction 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-how-to-save-the-currently-opened-view-as-a-new-view-variant-at-runtime/CS/EF/ViewVariantSaveEF/ViewVariantSaveEF.Module/Controllers/UserViewVariantsController.cs#L83

userViewVariantsCore.Execute -= UserViewVariants_Execute;
if ((changeVariantController != null) && (changeVariantController.ChangeVariantAction != null)) {
    changeVariantController.ChangeVariantAction.ExecuteCompleted -= ChangeVariantAction_ExecutedCompleted;