The ChangeVariantController is intended for presenting the ChangeVariant Action. This Action allows end-users to switch between predefined View Variants of a particular business object type.
In a Windows Forms application:
In an ASP.NET application:
The ChangeVariantController controller is provided by the View Variants module and is activated for all Views. You can use the Model Editor to customize the ChangeVariantController controller behavior via the ActionDesign | Controllers | DevExpress.ExpressApp.ViewVariantsModule.ChangeVariantController node. The ChangeVariant Action is accessible via the ActionDesign | Actions | ChangeVariant node.
For details on the ChangeVariant Action, refer to the description of the ChangeVariantController.ChangeVariantAction property, that provides access to this action.
This Controller uses the CurrentFrameViewVariantsManager object to populate the items of the ChangeVariant Action, switch the variant according to an end-user's selection and save the selected variant. By default, the last chosen variant identifier is stored with user customizations (in the Model.User.xafml file or in browser cookies). The VariantInfo structure is used to represent a single variant and the VariantsInfo class - to represent a set of variants available for a particular varied View.