Version

Synchronizing Check Boxes of the Tree Nodes

Synchronizing Checkboxes of the Tree Nodes

Topic Overview

Purpose

This topic demonstrates synchronizing checkboxes of the WinTree™ between parent and child nodes.

Introduction

In standard view, the WinTree already has the ability to display checkboxes on nodes. This feature provides the ability to synchronize the checkboxes automatically such that a parent node displays checked, unchecked or in an indeterminate state, based on the checked state of its child nodes.

Note
Note:

This feature only applies to nodes in the standard view of the tree nodes, not column views.

The following table illustrates how the checkbox states are synchronized and displayed.

Checkbox synchronization Checkbox state

Parent is checked if all children are checked.

Synchronizing Checkboxes of the Tree Nodes 1.png

Parent is unchecked if all children are unchecked.

Synchronizing Checkboxes of the Tree Nodes 2.png

Parent is indeterminate if some children are checked and others unchecked.

Synchronizing Checkboxes of the Tree Nodes 3.png
Note
Note:

This feature only applies to checkboxes appearing as follows:

  • Applies to nodes appearing in front of a result of the NodeStyle property

  • Does not apply to nodes displayed as either in a grid or in an OutlookExpress style

  • Does not apply to checkboxes in cells or columns

Example

Following is the code that enables checkbox synchronization via the NodeStyle property.

In C#:

ultraTree1.Override.NodeStyle = NodeStyle.SynchronizedCheckBox;

In Visual Basic:

ultraTree1.Override.NodeStyle = NodeStyle.SynchronizedCheckBox

Topics

The following topic provides additional information related to this topic.

Topic Purpose

In this section, you’ll find short, task-based topics that explain how to perform a specific task related to the WinTree™ control.