Skip to main content

WidgetView.AllowDocumentStateChangeAnimation Property

Gets or sets whether changing the Documents’ state within this WidgetView should be followed with animation effects.

Namespace: DevExpress.XtraBars.Docking2010.Views.Widget

Assembly: DevExpress.XtraBars.v22.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[DefaultValue(DefaultBoolean.Default)]
[XtraSerializableProperty]
public virtual DefaultBoolean AllowDocumentStateChangeAnimation { get; set; }

Property Value

Type Default Description
DefaultBoolean Default

A DefaultBoolean enumerator value that specifies whether changing the Documents’ state within this WidgetView should be followed with animation effects.

Available values:

Name Description Return Value
True

The value is true.

0

False

The value is false.

1

Default

The value is specified by a global option or a higher-level object.

2

Remarks

The AllowDocumentStateChangeAnimation property allows you to enable or disable animation effects for Document state change operations. These operations are: maximizing a Document, restoring a maximized Document back to the normal state and collapsing a Document. Use the IBaseDocumentDefaultProperties.AllowClose, IDocumentDefaultProperties.AllowMaximize and IDocumentDefaultProperties.AllowCollapse properties respectively to specify whether specific Documents support this behavior. The animation below demonstrates an animated Document maximization.

WidgetView - Maximized Content GIF

If the AllowDocumentStateChangeAnimation property is set to Default, the behavior is controlled by the WindowsFormsSettings.AnimationMode global setting. If the global setting is set to EnableAll, the animation is enabled. Otherwise, the animation is disabled.

Dragging Documents from one StackGroup to another is always animated and does not depend on the AllowDocumentStateChangeAnimation property value.

See Also