Version

Features Overview (xamTreeGrid)

Topic Overview

Purpose

This topic explains the features supported by the control from developer perspective.

Required background

The following table lists the concept and topics required as a prerequisite to understanding this topic.

Type Content

Concept

Data Presenter Family

Topics

Topic Purpose

This topic explains the concept of the Data Presenter Family of controls.

This is a set of topics explaining flexibility of the Data Presenter architecture and some common tasks (like data binding, assigning field layout and more…)

This is a set of topics explaining the major elements of the Data Presenter controls.

This topic provides an overview of the xamDataGrid control including a conceptual diagram of its comprising elements.

In this topic

This topic contains the following sections:

Introduction

XamTreeGrid summary

The xamTreeGrid is a control from the Data Presenter family which arranges data in a tree grid layout. Essentially the control is a xamDataPresenter that implements a single view (a TreeView) which cannot by dynamically switched.

Note
Note

If you need dynamically view switching you should use the xamDataPresenter and attach a ViewBase derived class to the View property.

The xamTreeGrid control is similar to the xamDataGrid in many aspects like data binding, field definition, events, commanding etc. This set of topics will describe the differences you need to know comparing to the xamDataGrid. This said it is a good idea to familiarize yourself with the concept and topics listed in the "Required Background" section.

Like the xamDataGrid, the xamTreeGrid has a view extending from the GridViewBase and because of this it lays out data out in columns and rows. There is an important addition however – one field is designated as the tree field. This is a field which contains a tree representation of the hierarchical data bound to the control. You have the ability to browse thought the nested records' levels by expanding and collapsing them using the designated expansion indicators.

The following screenshot shows the xamTreeGrid control displaying hierarchical structure of records with the tree positioned in the "Name" field. The "Name" field in this example is using a custom template for the TreeCellValuePresenter which displays an image for each record:

xamTreeGrid 02.png

Main Features

Main features summary

The following table summarizes the main features of the xamTreeGrid control in addition to the features supported by the xamDataGrid control. More details are available after the summary table.

Feature Description

You can specify field in which the tree will be positioned.

Expanding and collapsing of nested records.

Selection of cross-level records.

Filtering of multi-level records.

Multi-level records' summaries.

Exporting data to Microsoft® Excel® file format and Microsoft® Word® file format.

Tree Field

You can specify the field in which the tree will be displayed and also position the tree on the left or on the right side of the field using the xamTreeGrid’s FlowDirection property.

Related Topic:

Expand/Collapse

The control supports expanding and collapsing of nested records using expansion indicators. The initial state of the expansion indicators can be configured.

Related Topic:

Tree Selection

The control supports cross-level selection.

Related Topic:

Tree Filtering

The control supports multi-level record filtering. You can configure how the control displays records which do not match the filtering criteria.

Related Topic:

Tree Summaries

The control supports summaries for each nested record level. You can specify the calculators for each field.

Related Topic:

Exporting Data

As any other Data Presenter control, the xamTreeGrid support data exporting to popular Microsoft® Excel® file format and Word® file format.

Related Topics:

Related Content

Topics

The following topics provide additional information related to this topic.

Topic Purpose

This topic provides an overview of the visual elements of the control.

This topic explains what actions can be performed by the user.

This topic describes which features of the Data Presenter are not supported by this control.