Version

SelectionType Property

Gets/sets a value that determines how nodes are selected.
Syntax
'Declaration
 
Public Property SelectionType As SelectType
public SelectType SelectionType {get; set;}
Remarks

SelectionType determines how selection is handled and what kind of selection is allowed for a group of nodes.

Regardless of SelectionType, no two nodes under different parents may ever be selected simultaneously.

The SelectionType proeprty of the UltraTreeNodeOverride is ignored.

Example
The following sample code illustrates how to specify the selection strategy for nodes.

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinTree

Private Sub button9_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button9.Click

    ' Note: the Override objects are exposed as properties off
    ' the tree, the node and the nodes collection as well as
    ' items in the NodeLevelOverrides collection. This allows
    ' default settings to be specified for the tree, a node, 
    ' a node's children or for a level in the tree.

    ' Use the tree's Override property to
    ' set the default for all nodes.
    Me.ultraTree1.Override.SelectionType = SelectType.Extended

    ' Set the default for nodes that are at level 2 
    ' (i.e. grandchild nodes of root modes).
    ' This overrides the default setting above.
    Me.ultraTree1.NodeLevelOverrides(2).SelectionType = SelectType.None

    ' Set the default for nodes at the root level. 
    ' This overrides the default settings above.
    Me.ultraTree1.Nodes.Override.SelectionType = SelectType.Single

    Dim node As UltraTreeNode

    ' Get a specific node by its key value. 
    ' Note: this will return the node that has that key
    ' from anywhere in the tree structure since keys are
    ' unique across the entire tree.
    node = Me.ultraTree1.GetNodeByKey("child node 1")

    ' Note: Setting this property for a specific node is
    ' ignored since selection (e.g single/multi) is governed
    ' by the setting on the nodes collection that the node 
    ' is contained in. Therefore, the following commented
    ' out line would have no effect.
    'node.Override.SelectionType = SelectType.SingleAutoDrag

    ' Set the property for that specific node's child nodes
    node.Nodes.Override.SelectionType = SelectType.ExtendedAutoDrag

End Sub
using Infragistics.Win.UltraWinTree;

private void button9_Click(object sender, System.EventArgs e)
{

	// Note: the Override objects are exposed as properties off
	// the tree, the node and the nodes collection as well as
	// items in the NodeLevelOverrides collection. This allows
	// default settings to be specified for the tree, a node, 
	// a node's children or for a level in the tree.

	// Use the tree's Override property to
	// set the default for all nodes.
	this.ultraTree1.Override.SelectionType = SelectType.Extended;
		
	// Set the default for nodes that are at level 2 
	// (i.e. grandchild nodes of root modes).
	// This overrides the default setting above.
	this.ultraTree1.NodeLevelOverrides[2].SelectionType = SelectType.None;

	// Set the default for nodes at the root level. 
	// This overrides the default settings above.
	this.ultraTree1.Nodes.Override.SelectionType = SelectType.Single;

	// Get a specific node by its key value. 
	// Note: this will return the node that has that key
	// from anywhere in the tree structure since keys are
	// unique across the entire tree.
	UltraTreeNode node = this.ultraTree1.GetNodeByKey("child node 1");

	// Note: Setting this property for a specific node is
	// ignored since selection (e.g single/multi) is governed
	// by the setting on the nodes collection that the node 
	// is contained in. Therefore, the following commented
	// out line would have no effect.
	//node.Override.SelectionType = SelectType.SingleAutoDrag;

	// Set the property for that specific node's child nodes
	node.Nodes.Override.SelectionType = SelectType.ExtendedAutoDrag;

}
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also