TreeNodeAdv Features in Windows Forms MultiColumn TreeView

This section discusses the following topics.

OptionButton

Option button allows the user to select only one node out of all nodes.

Property Table

MultiColumnTreeView Properties

MultiColumnTreeView Property Description
ShowOptionButtons Indicates if the option button will be shown for the nodes.

TreeNodeAdv properties

TreeNodeAdv Property Description
ShowOptionButton Indicates if the option button will be shown for the node.
Optioned Gets or sets optioned state to a node
OptionButtonColor Gets or sets the option button back color for selected option node.
//Option button for all nodes in MultiColumnTreeView
this.multiColumnTreeView1.ShowOptionButtons = true;

//Option button for particular nodes
this.multiColumnTreeView1.Nodes[0].ShowOptionButton = true;

this.multiColumnTreeView1.Nodes[0].Optioned = true;
Me.multiColumnTreeView1.ShowOptionButtons = True

Me.multiColumnTreeView1.Nodes(0).ShowOptionButton = True

Me.multiColumnTreeView1.Nodes(0).Optioned = True

OptionButton support for the MultiColumnTreeView in TreeNodeAdv Features

CheckBox

The ShowCheckBoxes property when set will display check box for all the nodes. To apply checkbox to individual nodes, set the TreeNodeAdv.ShowCheckBox property, only for the required nodes in the NodeCollection Editor.

The InteractiveCheckBoxes indicates whether the state of the parent node’s checkbox is based on the check state of its child nodes checkboxes. To set this for individual nodes set the InteractiveCheckBox property of the TreeNodeAdv.

Property Table

MultiColumnTreeView Properties

MultiColumnTreeView Property Description
ShowCheckBoxes Indicates if the checkbox will be shown for the nodes.
InteractiveCheckBoxes Indicates if the state of the node's checkbox indicates the check state of the child node's checkboxes.
CheckedNodes Gets the Checked nodes collection

TreeNodeAdv Properties

TreeNodeAdv Property Description
ShowCheckBox Indicates if the checkbox of the node is visible.
InteractiveCheckBox Indicates if the node will have an interactive checkbox.
//Check box for all nodes in MultiColumnTreeView
this.multiColumnTreeView1.ShowCheckBoxes = true;

//Check box for particular nodes
this.multiColumnTreeView1.Nodes[0].ShowCheckBox = true;

this.multiColumnTreeView1.Nodes[0].Checked = true;
Me.multiColumnTreeView1.ShowCheckBoxes = True

Me.multiColumnTreeView1.Nodes(0).ShowCheckBox = True

Me.multiColumnTreeView1.Nodes(0).Checked = True

CheckBox support provided for the TreeNodeAdv Features in WindowsForms

Tristate CheckBox Settings

In the MultiColumnTreeView, the partial checking of the child nodes is supported. They are Checked State, Unchecked State and Intermediate State.
The CheckColor and CheckState property is used to set the color and the state of the check mark of the selected node. The options for the CheckState property are Checked, Unchecked and Indeterminate.

Property Table

TreeNodeAdv Property Description
CheckColor Indicates the color of the check mark.
CheckState Indicates the check state of the node.
IntermediateCheckColor Indicates the color of the check mark when it is in intermediate state or when its CheckState property is set to indeterminate.
Checked This indicates if the node's checkbox is checked.
EnsureDefaultOptionedChild This specifies if at least one child of the parent node should be selected always.

WindowsForms TreeNodeAdv feature given Tristate checkbox support

CustomControls

TreeNodeAdv can hold controls using custom control feature. This increases the functionality of the node, the nodes can hold controls like combo box, calendar etc.

TreeNodeAdv feature for the custom controls in MultiColumnTreeView

Editing the Node

LabelEdit

Indicates whether the label text of the tree nodes can be edited. By default, it is false . To edit the node,LabelEdit property must be set as true. BeforeEdit event occurs before a node gets into edit node.
For further details refer [editing event] (https://help.syncfusion.com/windowsforms/multicolumntreeview/multicolumntreeview-events#node-editing).

this.multiColumnTreeView1.LabelEdit = true;
Me.multiColumnTreeView1.LabelEdit = True

LabelEdit support for the TreeNodeAdv feature of the MultiColumnTreeView

Primitives

The MultiColumnTreeView control supports a set of primitive collections, that can be set through the Primitives Collection Editor available with each node in the MultiColumnTreeView controls.

The types of primitives available are LabelPrimitive, LeftImagePrimitive, RightImagePrimitive, CheckBoxPrimitive, OptionButtonPrimitive and CustomControlPrimitive.

The Primitive Collection Editor available for each node provides index property. Using this index set, for each primitive, the position for each of these node contents can be set.

  • LabelPrimitive - LabelPrimitive is used to display the text of the label.

  • LeftImagePrimitive - LeftImagePrimitive is used to display the image to the left of the nodes.

  • RightImagePrimitive - RightImagePrimitive is used to display the image that is added to the right of the nodes.

  • StateImagePrimitive - StateImagePrimitive is used to display the state image of the node depending on its state, whether expanded or collapsed.

  • CheckBoxPrimitive - CheckBoxPrimitive is used to display the checkbox for the nodes. When user clicks on this, the node will be checked.

  • OptionButtonPrimitive - OptionButtonPrimitive is used to display the Option button available for the nodes. When the user clicks this primitive, the corresponding node will be selected.

  • CustomControlPrimitives - CustomControlPrimitive displays the custom control for the nodes. User can use the functionality of the custom control primitive which is added to the nodes.

For adding the Primitives to the nodes, follow the steps below.

  1. Open the Primitives Collection Editor .

MultiColumnTreeView control supports a set of primitives

  1. Select the type of primitive in the combo box present at bottom left of the window and click Add.

WindowsForms-TreeNodeAdv in multiColumnTreeView provided primitive collection Editor

  1. Now the selected Primitive is added to that selected node.

Added Primitive collection to the nodes in the multiColumnTreeView in windowsForms