バージョン

BeforeExpand イベント

UltraTreeNode が展開される前に発生します。
シンタックス
'宣言
 
Public Event BeforeExpand As BeforeNodeChangedEventHandler
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 コントロールによって、このイベントが完了した後にノードに子ノードがあるかどうかが調べられます。ノードに子ノードがあれば、通常どおり展開されます。子ノードがなければ、展開インジケーターが非表示になります。

使用例
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
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;
		
}
参照