TdxWizardControlOptionsAnimate.ResizeAnimation Property

Specifies whether or not wizard size changes made with page transitions are animated.

Declaration

property ResizeAnimation: TdxWizardControlResizeAnimation read; write; default wcraDefault;

Property Value

Type	Default
TdxWizardControlResizeAnimation	wcraDefault

Remarks

The wizard control supports the standard VCL AutoSize mode. You can enable this mode to allow the wizard control to size itself automatically in order to accommodate the content of the currently active page. If your wizard pages vary in size, you can significantly improve the visual appeal of your wizard application by enabling this mode both for a wizard control and a form and allowing smooth sizing with animation via the ResizeAnimation property.

Size animation options include:

Value	Description
wcraDefault	The default setting. The wizard size animation is played based on the currently applied view style and is enabled only for Aero wizards. Select this option to make the wizard conform to the standard associated with the view style.
wcraEnabled	The wizard size changes are always animated, regardless of the currently applied view style.
wcraDisabled	The wizard size is always changed instantly, without animation, regardless of the currently applied view style.

You can limit the content size of individual wizard pages in AutoSize mode via a page OptionsSize option set. To limit the wizard control size and all wizard pages, use the dxWizardControlMinWidth and dxWizardControlMinHeight global constants.

We recommend that you use the specially designed wizard form (a TdxWizardControlForm object) for your wizard control and form in AutoSize mode. This form implements form sizing and positioning on screen, as well as proper form painting for Aero Glass theme effects in Aero wizards. To learn how to add this wizard form to your project, refer to this section.

Note

The ResizeAnimation setting is applied only if wizard page transitions are animated (see the TransitionEffect property description for details). The AutoSize mode is in effect only if the wizard control Align property, the Align property of page child controls, and a wizard form Align property are set to a value other than alClient.

The default value of the ResizeAnimation property is wcraDefault.