TreeList.EnableEnhancedScrolling Property

Gets or sets whether the Tree List uses an enhanced scroll mechanism, which only repaints the part of its area that becomes visible after a scroll operation.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v24.1.dll

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

Declaration

C#

[Browsable(false)]
public bool EnableEnhancedScrolling { get; set; }

VB.NET

<Browsable(False)>
Public Property EnableEnhancedScrolling As Boolean

Property Value

Type	Description
Boolean	true, if, during scrolling, Tree List redraws the part of its area that becomes visible, and does not invalidate the rest of the area; false, to repaint the scrollable area in its entirety.

Remarks

If the EnableEnhancedScrolling property is set to true, Tree List does not apply changes you perform via custom draw events for elements outside the newly visible scroll region. This may affect individual custom painting scenarios, for instance, if they rely on absolute positions of visual elements.

To restore the legacy scroll mechanism, which invalidates all visible elements during scroll operations, you can do one of the following:

• Set the EnableEnhancedScrolling property to false.
• Set the WindowsFormsSettings.DefaultSettingsCompatibilityMode property to v19_2 or any previous version. See Version Compatibility: Default Property Values for more information.

Note

The enhanced scroll mechanism is not applied in the following cases:

• The TreeList.OptionsView.ShowRowFooterSummary property is set to true.
• The TreeList.Appearance.Empty.BackColor2 property is set to a valid color.
• A background image is assigned to the tree list’s BackgroundImage property.