バージョン 24.2 (最新)

SelectionBehavior プロパティ

異なる Nodes コレクションに属する UltraTreeNode インスタンスを同時に選択できるかどうかを決定します。
シンタックス
public SelectionBehavior SelectionBehavior {get; set;}
解説

デフォルトで、UltraTree コントロールは異なる Nodes コレクションに属するノードの同時選択を許可しません。SelectionBehavior プロパティによって、ノードの UltraTreeNode.Level または UltraTreeNode.Parent にかかわらず、エンドユーザーがノード選択を拡張して元々選択されていたノードと異なる Nodes コレクションに属しているノードを含めることが可能です。

注: その他のプロパティ設定にかかわらず、Enabled プロパティが False に設定されているノードを選択できません。ノードの祖先のいずれかに対して Enabled が False に設定される時にこれも当てはまります。

コントロールの以前のバージョンでは、ノード選択の動作は SelectionType プロパティによって排他的に制御されました。特定のノードが選択可能だったかどうかは、プロパティの値は以下のように解決した上で (優先度の低い順に) SelectionType プロパティの解決された値によって決定されました:

  • ノードの UltraTreeNode.Parent の Nodes コレクション (またはルートレベル ノードでは Nodes コレクション) によって公開された Override で非デフォルト値が設定された場合、その値が使用されます。
  • ノードの UltraTreeNode.Level に対応する NodeLevelOverrides コレクションによって返される Override で非デフォルト値が設定された場合、その値が使用されます。
  • コントロール レベルの Override で非デフォルト値が設定された場合、その値が使用されます。
  • 明示的な設定がない場合、'Single' 設定が使用されます。
個々の UltraTreeNode によって公開された Override の SelectionType プロパティ値は適用されないことに注意してください。これはコントロールのレガシー バージョンの場合でも当てはまりました。

SelectionBehavior プロパティが 'ExtendedAcrossCollections' または 'ExtendedAutoDragAcrossCollections' に設定されると、以下の状況を除いて Override の SelectionType プロパティはもはや適用できません:

  • ノードの UltraTreeNode.Parent の Nodes コレクション (またはルートレベル ノードでは Nodes コレクション) によって公開された Override で SelectionType が 'None' に設定される場合、その値が認識されそのノードの選択は禁止されます。このようなノードが範囲選択の一部の時操作は許可されますが、これらのノードは選択から除外されます。
  • 前述の場合と同じように、そのノードのレベルで NodeLevelOverrides コレクションから返された Override で設定される時 'None' の設定も認識されます。
設定される Override にかかわらず、SelectionBehavior が 'ExtendedAcrossCollections' または 'ExtendedAutoDragAcrossCollections' に設定される時に SelectionType プロパティのその他すべての値は適用できません。

使用例
Imports System.Collections.Generic
Imports Infragistics.Win
Imports Infragistics.Win.Misc.UltraWinTree


    Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
        '  Set the SelectionBehavior property to 'ExtendedAcrossCollections'
        '  to allow nodes from different collections to be selected concurrently.
        Me.ultraTree1.SelectionBehavior = SelectionBehavior.ExtendedAcrossCollections

        '  Add nodes to the tree
        Me.PopulateTree(Me.ultraTree1)

        '  Determine the deepest level 
        Dim deepestLevel As Integer = Me.GetDeepestLevel(Me.ultraTree1)

        '  Only allow selection of leaf nodes
        Me.AllowSelectionOnLevel(Me.ultraTree1, deepestLevel)
    End Sub

    Private Sub PopulateTree(ByVal treeControl As UltraTree)
        Try

            treeControl.BeginUpdate()
            treeControl.Nodes.Clear()

            Dim i As Integer
            For i = 0 To 2

                Dim text As String = String.Format("Root {0}", i)
                Dim rootNode As UltraTreeNode = treeControl.Nodes.Add(Nothing, text)
                Me.PopulateNodes(rootNode.Nodes, 1)
            Next

        Finally
            treeControl.EndUpdate()
        End Try

        treeControl.ExpandAll()

    End Sub

    Private Sub PopulateNodes(ByVal nodesCollection As TreeNodesCollection, ByVal level As Integer)

        If (level > 3) Then Return

        Dim parentNode As UltraTreeNode = nodesCollection.ParentNode

        Dim i As Integer
        For i = 0 To 2

            Dim text As String = String.Format("{0}\Node {1}", parentNode.Text, i)
            Dim node As UltraTreeNode = nodesCollection.Add(Nothing, text)

            If (level < 3) Then
                Me.PopulateNodes(node.Nodes, level + 1)
            End If
        Next

    End Sub

    Public Sub AllowSelectionOnLevel(ByVal tree As UltraTree, ByVal level As Integer)

        Dim levels As New List(Of Integer)
        levels.Add(level)
        Me.AllowSelectionOnLevels(tree, levels)

    End Sub

    Public Sub AllowSelectionOnLevels(ByVal tree As UltraTree, ByVal levels As List(Of Integer))

        Dim deepestLevel As Integer = Me.GetDeepestLevel(tree)

        Dim i As Integer
        For i = 0 To deepestLevel
            tree.NodeLevelOverrides(i).ResetSelectionType()
            If (levels.Contains(i)) Then Continue For
            tree.NodeLevelOverrides(i).SelectionType = SelectType.None
        Next

    End Sub

    Public Function GetDeepestLevel(ByVal tree As UltraTree) As Integer

        Dim deepestLevel As Integer = 0
        Me.GetDeepestLevel(tree.Nodes, deepestLevel)
        Return deepestLevel

    End Function

    Private Sub GetDeepestLevel(ByVal nodes As TreeNodesCollection, ByRef deepestLevel As Integer)

        Dim i As Integer
        For i = 0 To nodes.Count - 1
            Dim node As UltraTreeNode = nodes(i)
            If (i = 0) Then deepestLevel = Math.Max(deepestLevel, node.Level)
            If (node.HasNodes) Then Me.GetDeepestLevel(node.Nodes, deepestLevel)
        Next

    End Sub
'宣言
 
Public Property SelectionBehavior As SelectionBehavior
 
using System.Collections.Generic;
using Infragistics.Win;
using Infragistics.Win.Misc.UltraWinTree;

    private void Form1_Load(object sender, EventArgs e)
    {
        //  Set the SelectionBehavior property to 'ExtendedAcrossCollections'
        //  to allow nodes from different collections to be selected concurrently.
        this.ultraTree1.SelectionBehavior = SelectionBehavior.ExtendedAcrossCollections;

        //  Add nodes to the tree
        this.PopulateTree( this.ultraTree1 );

        //  Determine the deepest level 
        int deepestLevel = this.GetDeepestLevel( this.ultraTree1 );

        //  Only allow selection of leaf nodes
        this.AllowSelectionOnLevel( this.ultraTree1, deepestLevel);
    }

    private void PopulateTree( UltraTree treeControl )
    {
        try
        {
            treeControl.BeginUpdate();

            treeControl.Nodes.Clear();

            for ( int i = 0; i < 3; i ++ )
            {
                string text = string.Format( "Root {0}", i );
                UltraTreeNode rootNode = treeControl.Nodes.Add( null, text );
                this.PopulateNodes( rootNode.Nodes, 1 );
            }

        }
        finally
        {
            treeControl.EndUpdate();
        }

        this.ultraTree1.ExpandAll();
    }

    private void PopulateNodes( TreeNodesCollection nodesCollection, int level )
    {
        if ( level > 3 )
            return;

        UltraTreeNode parentNode = nodesCollection.ParentNode;

        for ( int i = 0; i < 3; i ++ )
        {
            string text = string.Format( @"{0}\Node {1}", parentNode.Text, i );
            UltraTreeNode node = nodesCollection.Add( null, text );
            
            if ( level < 3 )
                this.PopulateNodes( node.Nodes, level + 1 );
        }            
    }

    public void AllowSelectionOnLevel( UltraTree tree, int level )
    {
        List<int> levels = new List<int>(1);
        levels.Add( level );
        this.AllowSelectionOnLevels( tree, levels );
    }

    public void AllowSelectionOnLevels( UltraTree tree, List<int> levels )
    {
        int deepestLevel = this.GetDeepestLevel( tree );
        for ( int i = 0; i <= deepestLevel; i ++ )
        {
            tree.NodeLevelOverrides[i].ResetSelectionType();

            if ( levels.Contains(i) )
                continue;

            tree.NodeLevelOverrides[i].SelectionType = SelectType.None;
        }

    }

    public int GetDeepestLevel( UltraTree tree )
    {
        int deepestLevel = 0;
        this.GetDeepestLevel( tree.Nodes, ref deepestLevel );
        return deepestLevel;
    }

    private void GetDeepestLevel( TreeNodesCollection nodes, ref int deepestLevel )
    {
        for ( int i = 0; i < nodes.Count; i ++ )
        {
            UltraTreeNode node = nodes[i];

            if ( i == 0 )
                deepestLevel = Math.Max( deepestLevel, node.Level );

            if ( node.HasNodes )
                this.GetDeepestLevel( node.Nodes, ref deepestLevel );
        }
    }
'宣言
 
Public Property SelectionBehavior As SelectionBehavior
 
参照