BeforeRowCancelUpdate イベント

ユーザーが［ESC］キーを押して行の更新を取り消す前に発生します。

シンタックス

Visual Basic

'宣言
 
Public Event BeforeRowCancelUpdate As CancelableRowEventHandler

C#

public event CancelableRowEventHandler BeforeRowCancelUpdate

イベント データ

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

プロパティ	解説
Cancel System.ComponentModel.CancelEventArgsから継承されます。
Row	セルが属する行を返します。

解説

row 引数は、更新がキャンセルされる行のプロパティの設定やそのメソッドの呼び出しに使用できる、UltraGridRowオブジェクトへの参照を返します。この参照を使用して、返された行のプロパティを設定したり、メソッドを呼び出したりすることができます。

cancel 引数を使用して、行の更新がキャンセルされないようにプログラミングできます。この引数を使用すると、一定の条件が満たされないかぎり、ユーザーが更新をキャンセルできないようにすることができます。

このイベントは、ユーザーが ［Esc］ キーを押して行内のセルの変更をキャンセルしたときに生成されます。CancelUpdate メソッドが呼び出された場合も生成されます。

AfterRowCancelUpdate イベントは、 cancel が True に設定されず、行の更新がキャンセルされた後 (このイベントの後) に発生します。

使用例

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid
Imports System.Diagnostics

   Private Sub UltraGrid1_BeforeRowCancelUpdate(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.CancelableRowEventArgs) Handles ultraGrid1.BeforeRowCancelUpdate

       ' ユーザーが行のセルを変更して 2 回 Escape キーを押すと、 
       ' 行の変更をキャンセルし、このイベントが発生されます

       Dim result As DialogResult = MessageBox.Show( _
           "Are you sure you want to cancel changed you've made in the row ?", _
           "Confirm", MessageBoxButtons.YesNo, MessageBoxIcon.Question)

       If DialogResult.No = result Then
           e.Cancel = True
       Else
           Debug.WriteLine("Changes in row with index of " & e.Row.Index.ToString() & " has been discarded since last updated.")
       End If

   End Sub

C#

using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

private void ultraGrid1_BeforeRowCancelUpdate(object sender, Infragistics.Win.UltraWinGrid.CancelableRowEventArgs e)
{

	// ユーザーが行のセルを変更して 2 回 Escape キーを押すと、 
	// 行の変更をキャンセルし、このイベントが発生されます

	DialogResult result = MessageBox.Show( 
		"Are you sure you want to cancel changed you've made in the row ?",
		"Confirm", MessageBoxButtons.YesNo, MessageBoxIcon.Question );

	if ( DialogResult.No == result )
	{
		e.Cancel = true;
	}
	else
	{
		Debug.WriteLine( "Changes in row with index of " + e.Row.Index.ToString( ) + " has been discarded since last updated." );
	}

}