BeforeExpand イベント

UltraTreeNode が展開される前に発生します。

シンタックス

Visual Basic

'宣言
 
Public Event BeforeExpand As BeforeNodeChangedEventHandler

C#

public event BeforeNodeChangedEventHandler BeforeExpand

イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、CancelableNodeEventArgs 型の引数を受け取りました。次の CancelableNodeEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ	解説
Cancel System.ComponentModel.CancelEventArgsから継承されます。
TreeNode	UltraTreeNode (読み取り専用)

解説

CancelableNodeEventArgs の CancelableNodeEventArgs.TreeNode プロパティには、展開される UltraTreeNode への参照が格納されます。

System.ComponentModel.CancelEventArgs.Cancel プロパティを True に設定すると、UltraTreeNode は展開されません。

Override.ShowExpansionIndicator を CheckOnExpand に設定しているときは、このイベントを使用して特定の UltraTreeNode の子ノードを設定してください。このイベントがキャンセルされなければ、UltraTree コントロールによって、このイベントが完了した後にノードに子ノードがあるかどうかが調べられます。ノードに子ノードがあれば、通常どおり展開されます。子ノードがなければ、展開インジケーターが非表示になります。

使用例

Visual Basic

Imports Infragistics.Win.UltraWinTree

Private Sub ultraTree1_BeforeExpand(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinTree.CancelableNodeEventArgs) Handles ultraTree1.BeforeExpand

    ' 注: ノード コレクションをオンデマンドに読み込むために、
    ' 適切な Override オブジェクトの ShowExpansionIndicator  
    ' プロパティを CheckOnExpand に設定しますこのイベントでは、展開されているノードに 
    ' 子ノードを追加するロジックを追加します 
    ' (e.TreeNode.Node の Add または AddRange メソッドなど)
    '
    ' Tag プロパティのほかに、ノードが (ノードに隠される) 
    ' DataKey プロパティも公開します
    ' CheckOnDemand を使用すると、データセットの対応行の
    ' 識別子またはキーを関連することは便利です
    '
    ' CheckOnExpand が有効された場合、このイベントが呼び出して 
    ' 子ノードが追加されなかった場合、展開インジケーターを非表示にして
    ' このイベントは再発生しません 
    '
    ' ただし、UltraTree の ResetExpansionIndicator メソッドを 
    ' 呼び出すと、展開インジケーターを表示し、
    ' ユーザーがノードを展開するときに、このイベントを
    ' 再発生されます
    '
    ' 「UltraTree ロードオンデマンド VB」サンプルを参照してください

    Dim sb As New System.Text.StringBuilder()

    sb.Append("Node: ")
    sb.Append(e.TreeNode.Key)
    sb.Append(" is about to be expanded.")

    Debug.WriteLine(sb.ToString())

    ' 注: この操作が以下のコード行によってキャンセルできます
    'e.Cancel = True

End Sub

C#

using System.Diagnostics;
using Infragistics.Win.UltraWinTree;

private void ultraTree1_BeforeExpand(object sender, Infragistics.Win.UltraWinTree.CancelableNodeEventArgs e)
{

	// 注: ノード コレクションをオンデマンドに読み込むために、
	// 適切な Override オブジェクトの ShowExpansionIndicator 
	// プロパティを CheckOnExpand に設定しますこのイベントでは、展開されているノードに 
	// 子ノードを追加するロジックを追加します 
	// (e.TreeNode.Node の Add または AddRange メソッドなど)
	//
	// Tag プロパティのほかに、ノードが (ノードに隠される)
	// DataKey プロパティも公開します
	// CheckOnDemand を使用すると、データセットの対応行の
	// 識別子またはキーを関連することは便利です
	//
	// CheckOnExpand が有効された場合、このイベントが呼び出して 
	// 子ノードが追加されなかった場合、展開インジケーターを非表示して
	// このイベントは再発生しません 
	//
	// ただし、UltraTree の ResetExpansionIndicator メソッドを 
	// 呼び出すと、展開インジケーターを表示し、
	// ユーザーがノードを展開するときに、このイベントを
	// 再発生します
	//
	// 「UltraTree ロードオンデマンド CS」サンプルを参照してください
	
	System.Text.StringBuilder sb = new System.Text.StringBuilder();

	sb.Append("Node: ");
	sb.Append(e.TreeNode.Key);
	sb.Append(" is about to be expanded.");

	Debug.WriteLine( sb.ToString() );

	// 注: この操作は以下のコードによってキャンセルできます
	//e.Cancel = true;
		
}