System.Web.UI.WebControls.TreeView.ShowCheckBoxes Property

Gets or sets a value indicating which node types will display a check box in the System.Web.UI.WebControls.TreeView control.

Syntax

[System.ComponentModel.DefaultValue(System.Web.UI.WebControls.TreeNodeTypes.None)]
public TreeNodeTypes ShowCheckBoxes { set; get; }

Value

Documentation for this section has not yet been entered.

Remarks

To provide multi-node selection support in the System.Web.UI.WebControls.TreeView control, you can display check boxes next to the image for a node. Use the TreeView.ShowCheckBoxes property to specify which node types will display a check box. For example, if this property is set to TreeNodeType.Parent, check boxes are displayed for each parent node in the tree. The following table lists the valid values for this property.

TreeNodeType.All

Check boxes are displayed for all nodes.

TreeNodeType.Leaf

Check boxes are displayed for all leaf nodes.

TreeNodeType.None

Check boxes are not displayed.

TreeNodeType.Parent

Check boxes are displayed for all parent nodes.

TreeNodeType.Root

Check boxes are displayed for all root nodes.

The enumeration type that is used for the TreeView.ShowCheckBoxes property is a flag enumeration, which allows you to combine values through bitwise operations. For example, to display check boxes for the parent and leaf nodes, use the bitwise OR operator to combine the TreeNodeType.Parent and TreeNodeType.Leaf values.

To determine which nodes have their check box selected, iterate through the nodes of the TreeView.CheckedNodes collection.

Note:

You can override the TreeView.ShowCheckBoxes setting by setting the TreeNode.ShowCheckBox property for each node.

If you need to provide only single-selection support, consider using the TreeView.SelectedNode property.

The value of this property is stored in view state.

Requirements

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0