With an autoobject variant member you can override another autoobject member existing in your project. Once overridden, the variant member can retrospectively modify the properties of the original autoobject member. Autoobject variant members are represented in Composer by following bricks. Please note the additional small overlay in the icon of the brick:

The derivation of variants provides the fundamental technique to manage several product and design versions within one and the same GUI application. The selection of the appropriate variant occurs automatically depending on the condition specified in the VariantCond attribute of the variant member. Depending on this condition, Embedded Wizard distinguishes between following two types of a variant:

Type	Short description
Static	The condition for the selection of the respective variant results in a value well known at the code compilation time and immutable at the runtime. If this condition is true, the affected variant overrides the original autoobject member permanently. If the condition is false, the variant has no effect.
Dynamic	The condition for the variant selection depends on styles. Since styles can be activated and deactivated individually at the runtime, the overriding changes dynamically.

An autoobject member, which has been overridden by a variant member is considered as being multi-variant. You can derive as many variants of an original member as you want. Moreover, one autoobject variant can override another autoobject variant resulting in a hierarchy of variants. With the Browser window you can inspect this hierarchy. Please note, a member overridden by a variant is signed in the Browser with an additional small icon. You can thus recognize multi-variant members easily. Additionally, the corresponding variant condition is shown between a pair of [...] (squared brackets):

The original autoobject member is overridden by a variant, which, in turn, is overridden by another variant. Both variants specify as condition true and are thus static.

You create a new autoobject variant by simply deriving it from an existing autoobject or another autoobject variant. In the simplest case, if both, the original member and the variant are defined within the same unit, do following:

Deriving a new variant from an autoobject member existing within the same unit.

If the original member is not defined within the same unit, you can use the Browser window:

Deriving a new variant by using the Browser window.

Alternatively, you can derive a new variant by using the clipboard functions Copy & Paste:

Variant members have a global character - they can be accessed from everywhere within your project. To address a variant member, you must always use its full name, which is composed of the unit name, the member is defined inside, and the name of the member itself, both separated by :: (double colon) signs. For example Examples::DeviceInterfaceCANBusVariant.

The effect of an overriding depends on the condition you specify in the attribute VariantCond of the respective variant member. Per default newly derived variants are configured with the condition true. They overrides thus statically and permanently the original member. You should therefore always review this attribute after deriving a new variant.

Please note, if two variants override the same original member and both variants are configured with the same condition, Embedded Wizard will report a compilation error because of the ambiguity.

The variant exposes exact the same set of properties as the original autoobject member. When the autoobject variant is selected, you can inspect and modify these properties directly in the Inspector window. As long as not modified, a property contains the value inherited from the original member. When you modify a property, its original value is overridden.

Once overridden properties can be revert easily by pressing the keys CtrlR when the affected property is selected in Inspector. Thereupon, the value inherited from the original member is restored again.

You can create any number of copies of an already existing autoobject variant member.

You can also Drag & Drop an autoobject variant member from the Browser into the Composer window and create so a duplicate of the affected member:

Duplicating an autoobject variant by simply Drag & Drop it between the Browser and Composer windows

Embedded Wizard selects the appropriate variant automatically either at the code generation time or just at the moment when the corresponding original autoobject is evaluated within an expression. Accessing the autoobject variants individually is not possible. The selection is controlled by the attribute VariantCond.

The following table shows the complete list of attributes provided by the autoobject variant member. Please note, besides the attributes, an autoobject also exposes all properties defined in its class:

Attribute name	Short description
Brick	Determines the position and the size of an variant member brick within the Composer window.
Class	Determines the class of an autoobject member. Please note, this attribute can't be modified in derived variants.
Description	Contains the description for the variant member.
VariantCond	Determines the condition to activate a particular variant member.
VariantOf	Determines the original autoobject member to override by the variant member.