Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [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]Pivot Grid
  [Collapse]Tree List
   [Expand]Product Information
   [Expand]Feature Center
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]Examples
   [Expand]End User Capabilities
   [Expand]Member Tables
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
[Expand]End-User Documentation

Tree List

Overview


The DevExpress WinForms Tree List is a hybrid control that allows you to display data as a tree, a grid, or a combination of both, regardless of data complexity. The Tree List can be used in either bound or unbound mode, with full support for data editing and validation. Since it includes grid functionality, you can also sort, filter and search for data, as well as calculate summaries using aggregate functions. Like other DevExpress WinForms controls, the Tree List fully supports DevExpress skins, so that you can customize the appearance of your application.

Refer to the following links for detailed info.

 

Learn the Basics


This section includes articles that cover essential Tree List control terms and techniques.

  • Main Features
    Enumerates all Tree List capabilities in a compact list format.

  • Visual Elements
    Demonstrates all UI elements provided by the Tree List control.

Nodes


The Tree List control displays records of the associated data source by means of nodes. Nodes, however, can be much more complex than a number of cells displaying dataset field values. The documents in this section describe the term "node", and provide information on how to perform operations on nodes.

  • Node Objects
    An overview topic that explains what Tree List nodes are.

  • Node Structure
    Learn what elements nodes can contain and what properties are used for these elements.

  • Using the Nodes Iterator
    Nodes iterator is an object that allows you to traverse Tree List nodes without writing recursive code manually.

  • Custom Nodes
    This topic shows how to create custom nodes and use them in your Tree List control.

Columns


The Tree List control displays data by means of nodes and columns. Nodes correspond to individual records, while columns represent data source fields. This section contains description for columns themselves and elements related to the column layout - bands and preview sections.

  • Columns
    The title columns article. Contains the detailed info on columns, their layout, behavior and appearance settings.

  • Fixed Columns
    Learn how to anchor specific columns to the left or right of a control's edge.

  • Bands
    Bands are visual and logical groups into which you can arrange columns. You can hide, display and reorder bands along with their child columns. This document describes the band features, how to anchor bands and how to organize them into a hierarchical structure.

  • Preview Sections
    Preview sections are regions below Tree List records, stretched across the entire node width. These regions are non-editable and designed to display large memo fields or custom data for a given record.

Data Binding


This section contains all required info related to binding the Tree List control to various data types, as well as operating in unbound mode.

  • Data Binding Common Concepts
    In this section you will find general information on data binding concepts, shared among all DevExpess data-aware controls.

  • Tree Generation Algorithm in the Tree List
    Learn how the Tree List generates its node hierarchy and what requirements the control provides for the data source.

  • Virtual Mode (Dynamic Data Loading) Using Events
    Explains how to load data into a Tree List dynamically using only events (virtual mode).

  • Virtual Mode by Binding to a Business Object
    This topic is dedicated to a particular case of virtual mode where the Tree List is bound to an instance of a custom class.

  • Unbound Mode
    The overview article dedicated to the Tree List Unbound Mode.

  • Unbound Columns
    This page covers unbound columns, which help you display custom data within the Tree List control. These columns are not bound to fields in the data source, and data for these columns needs to be provided using expressions or a dedicated event.

Data Editing


Articles in this section demonstrate different data editing approaches supported by the Tree List control.

Sorting


Topics in this section provide information about sorting Tree List data against specific columns.

Filtering


Data filtering is an essential requirement for most software applications. The Tree List Suite is packed with numerous filtering features, so that you can deliver a solution that best meets your customer's requirements.
  • Microsoft Excel Style Filter Dropdowns
    The simplest end-user filtering tasks can be accomplished using Filter Dropdown Lists. These lists mimic the filtering UI implemented in Microsoft Excel.

  • Automatic Filtering Row
    The Auto Filter Row is a row, displayed above all other nodes, which allows end users to filter data by entering filter values within its cells.

  • Advanced Filter Editor Dialog
    With this dialog, you will be able to build filter criteria of any complexity - create any number of conditions and combine them in any manner using any logical operator.

  • Filtering in Code
    Filtering using an event allows you to create a filter of any complexity, and hide any nodes you want from the screen.

Summaries


The Tree List control provides a summary feature for calculating the value of an aggregate function over column values. This section lists the available summary types and describes methods of formatting the displayed summary. It also contains a brief description of end-user capabilities for configuring and using summaries.
  • Summary Types
    Enumerates various summary types available in the Tree List control.

  • Total Summaries
    This topic describes how to implement total summaries calculated against all or only root nodes.

  • Group Summaries
    Contains information related with setting up group summaries, calculated for each group of nodes that have the same parent.

  • Custom Summaries
    This topic illustrates how to implement custom aggregate functions.

  • Formatting Summary Values
    Learn how to format a summary's text and change the appearance of summary values.

Formatting Cell Values


The Tree List gives you the ability to format column values in display mode (when in-place editors are not active). This section lists which members can be used to format values, provides links to the documents that describe the formatting mechanism and provides task-based examples.
  • Formatting Approaches
    Briefly describes formatting approaches available for the Tree List control.

  • Members that Support the Formatting Mechanism
    Enumerates properties that affect cell formats.

  • Format Specifiers
    Format specifiers are symbols that specify the way data is formatted during its conversion to a string. This topic describes frequently used standard and custom format specifiers used to format numeric and date/time values.

  • Composite Formatting
    The Composite Formatting feature allows you to add custom text to the output formatted string.

  • Custom Formatting
    The Custom Formatting feature allows you to format values that are neither numeric nor date/time and implement complex formatting of numeric or date/time values.

Other Concepts


Miscellaneous


  • Design-Time Features
    This section covers the design-time features of the Tree List control.

  • Context Menus
    The Tree List provides context menus for its elements that contain most used commands. There are context menus for column headers, group summary footers and the total summary footer. This section contains information on these menus and shows how to extend their capabilities.

  • Printing the Tree List control
    Learn how to print the Tree List control using the DevExpress Printing library.

  • Export and Import Data
    This topic describes the control's export and import capabilities and limitations.

  • End User Capabilities
    Topics in this section describe the operations available to end-users of the Tree List control.

  • Examples
    Contains task-based examples for the Tree List control.

 

How would you rate this topic?​​​​​​​