BeforeCheck イベント

ノードの CheckedState が変更する前に発生します。

シンタックス

Visual Basic

'宣言
 
Public Event BeforeCheck As BeforeCheckEventHandler

C#

public event BeforeCheckEventHandler BeforeCheck

イベント データ

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

プロパティ	解説
Cancel System.ComponentModel.CancelEventArgsから継承されます。
NewValue	ノードのチェックボックスに新しい値を設定します。
TreeNode Infragistics.Win.UltraWinTree.CancelableNodeEventArgsから継承されます。	UltraTreeNode (読み取り専用)

解説

CancelableNodeEventArgs の CancelableNodeEventArgs.TreeNode プロパティには、CheckedState が変更される UltraTreeNode への参照を含みます。

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

BeforeCheckEventArgs.NewValue パラメーターは、UltraTreeNode の CheckedState プロパティの新しい値を取得または設定します。

このイベントは、その Override.NodeStyle が CheckBox、CheckBoxTriState、または OptionButton に設定されるノードに限り適用されます。

使用例

Visual Basic

Imports Infragistics.Win.UltraWinTree

Private Sub ultraTree1_BeforeCheck(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinTree.BeforeCheckEventArgs) Handles ultraTree1.BeforeCheck

    Dim sb As New System.Text.StringBuilder()

    sb.Append("Node: ")
    sb.Append(e.TreeNode.Key)
    sb.Append(" check state is about to change from ")
    sb.Append(e.TreeNode.CheckedState)
    sb.Append(" to ")
    sb.Append(e.NewValue)

    Debug.WriteLine(sb.ToString())

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

End Sub

C#

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

private void ultraTree1_BeforeCheck(object sender, Infragistics.Win.UltraWinTree.BeforeCheckEventArgs e)
{

	System.Text.StringBuilder sb = new System.Text.StringBuilder();

	sb.Append("Node: ");
	sb.Append(e.TreeNode.Key);
	sb.Append(" check state is about to change from ");
	sb.Append(e.TreeNode.CheckedState);
	sb.Append(" to ");
	sb.Append(e.NewValue);

	Debug.WriteLine( sb.ToString() );
		
	// 注: この操作が以下のコード行によってキャンセルできます
	//e.Cancel = true;

}