Version

Configuring Selection (xamTreeGrid)

Topic Overview

Purpose

This topic explains how to configure the selection behavior for child level records.

Required background

The following topics are prerequisites to understanding this topic:

Topic Purpose

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

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

This topic provides overview information about the selection of the data presenter’s cells, rows and fields.

Selection Summary

Selection summary

The xamTreeGrid control allows you to configure (via property) which records are selected in response to a user selecting a range of records or cells. The three cases below have the same initial state:

  • No initial selection

  • The "Documents" record is expanded

  • The "Users" record is collapsed

  • The user performs cross-level selection by clicking on the "Boot" record selector and then shift-clicks on the "Windows" record selector

  • After the selection is done the user expands the "Users" record

"Single" Depth Selection Mode

xamTreeGrid 05.png

In this case no nested records are selected regardless of the expanded state of their parent record. Only records on the current selection level are selected. This is the default setting for GridView.

"VisibleOnly" Depth Selection Mode

xamTreeGrid 06.png

In this case all visible records between the pivot record and the end selection record are selected. The records under the "Users" record were not selected because they became visible after the selection was made. This is the default setting for TreeView.

"All" Depth Selection Mode

xamTreeGrid 07.png

In this case all records (at the selection level and all nested levels) were selected regardless of the expanded state of their parent.

Selection configuration summary

The following table explains briefly the configurable aspect of the xamTreeGrid control and maps it to the property that configure it.

Configurable aspect Details Properties

Selection Mode

Specify the cross-level depth selection mode.

Note
Note

To obtain selected item(s) please look at the following data presenter selection - related topics:

Code example

The following code example show how to set the cross-level depth selection mode to "VisibleOnly".

In XAML:

<igDP:XamTreeGrid>
  <igDP:XamTreeGrid.ViewSettings>
    <igDP:TreeViewSettings SelectionDepthMode="VisibleOnly" />
  </igDP:XamTreeGrid.ViewSettings>
</igDP:XamTreeGrid>

The following topics provide additional information related to this topic.

Topic Purpose

This topic explains how to configure the control’s tree field.

This topic explains how to configure the expansion indicators' behavior.

This topic explains how to set the indentation used to render the child records.

This topic explains how to configure the filtering feature of the control.

This topic explains the specifics of the summaries support of the control.