[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Collapse]Tree List
   [Expand]Product Information
   [Collapse]Feature Center
    [Expand]Data Binding
    [Expand]Data Editing
    [Expand]Data Presentation
    [Expand]Appearances and Look And Feel
    [Collapse]Focus, Selection and Navigation
      Focus and Navigation
      Node Selection
      Breadcrumb Navigation
      Node Checking - Checkboxes and Radio Buttons
      Scrollbar Annotations
     Formatting Cell Values
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]End User Capabilities
   [Expand]Member Tables
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Scrollbar Annotations

When tree lists contain many nodes, locating those with validation errors (see TreeList.SetColumnError) and those that are focused (see TreeList.FocusedNode) or selected (see TreeList.Selection) can be difficult. To help locate these nodes expeditiously, display scrollbar annotations. The latter are colored marks on the vertical scrollbar that reflect the location of corresponding nodes in the tree list.

Expanded How to Enable

The TreeList.OptionsScrollAnnotations property provides access to options that allow you to enable/disable specific annotations.

  • ShowErrors — specifies whether to mark nodes with validation errors
  • ShowFocusedRow — specifies whether to mark the focused node
  • ShowSelectedRows — specifies whether to mark selected nodes
  • ShowCustomAnnotations — specifies whether to mark nodes with custom annotations provided using a dedicated event (see below)

Scrollbar annotations are disabled if an option equals Default. Set the option to True to enable them.

Tree list also displays scrollbar annotations for search requests if the Find Panel is in search mode.


Scrollbar annotations have the following limitations.

Expanded Custom Annotations

The TreeList.CustomScrollAnnotation event allows you to provide data about custom annotations. Data is represented by the TreeListScrollAnnotationInfo type, which exposes the following properties.

  • Node — the node for which to show a scroll annotation
  • Color — color of the annotation

When handling this event, create data objects and add them to the Annotations collection in the event arguments.

The SetAnnotations method allows you to set annotations for a node array. Note that this method does not add annotations, but resets them.

Expanded How to Create Row Bookmarks Using Scrollbar Annotations and Node Indicators


Run the Scrollbar Annotations & Bookmarks demo to see the functionality in action.

You can provide users with the ability to bookmark nodes and navigate between them using the keyboard. To implement this functionality, handle the following events.

Expanded See Also

Is this topic helpful?​​​​​​​