TreeListOptionsBehavior.AllowExpandAnimation Property

Gets or sets whether to use animation effects when expanding/collapsing nodes using the expand button.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v21.2.dll

NuGet Packages: DevExpress.Win.Design, DevExpress.Win.TreeList

Declaration

C#

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

VB.NET

<DefaultValue(DefaultBoolean.Default)>
<XtraSerializableProperty>
Public Overridable Property AllowExpandAnimation As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	Default	True, to use animation effects; otherwise, False; Default uses the WindowsFormsSettings.AnimationMode static (Shared in VB) setting.

Available values:

Name	Description
True	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
Default	The default behavior determined by the control’s logic.

Property Paths

You can access this nested property as listed below:

Object Type	Path to AllowExpandAnimation
TreeList	.OptionsBehavior .AllowExpandAnimation

Remarks

End-users can expand/collapse nodes using the expand button. The AllowExpandAnimation property specifies whether to use animation effects when expanding/collapsing nodes. If this property is set to Default, the actual behavior depends on the WindowsFormsSettings.AnimationMode static setting. If the global setting is set to Default or EnableAll, the animation effects are enabled; otherwise, they are disabled.

If you subscribe to the TreeList.BeforeExpand, TreeList.BeforeCollapse, TreeList.AfterExpand or TreeList.AfterCollapse event and the AllowExpandAnimation setting is Default, the expand/collapse animation effects are forcibly disabled.

In code, you can expand/collapse a node using the TreeListNode.Expand, TreeList.ExpandAll, TreeList.CollapseAll, TreeList.ExpandToLevel and TreeList.CollapseToLevel methods. When expanding/collapsing nodes in code, the animation is always disabled, regardless of the AllowExpandAnimation property value.