BeforeCellCancelUpdate イベント

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

シンタックス

Visual Basic

'宣言
 
Public Event BeforeCellCancelUpdate As CancelableCellEventHandler

C#

public event CancelableCellEventHandler BeforeCellCancelUpdate

イベント データ

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

プロパティ	解説
Cancel System.ComponentModel.CancelEventArgsから継承されます。
Cell	対象となるセルへの参照を返します。

解説

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

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

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

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

使用例

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

  Private Sub UltraGrid1_BeforeCellCancelUpdate(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.CancelableCellEventArgs) Handles ultraGrid1.BeforeCellCancelUpdate

      ' 以下のコードは、BeforeCellCancelUpdate を使用すると、
      ' セルの編集モードを終了せずにセルの値を元の値に戻す 
      ' 方法を紹介しますEscape キーが押されると、通常 UltraGrid は編集しているセルの値を
      ' 元に戻して、編集モードを終了します編集モードを終了しない
      ' 方が良い場合がありますそのような動作を実装するには、 
      ' BeforeCellCancelUpdate イベントを使用します

      ' エディターの Value をセルの値に設定しますこれによって値を
      ' セルの元の値に戻しますUltraGridCell.Value プロパティは
      ' 基本のバインド リストの値を返します
      e.Cell.Column.Editor.Value = e.Cell.Value

      ' Cancel を True に設定すると、編集モードを
      ' 終了しません
      e.Cancel = True

  End Sub

C#

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

private void ultraGrid1_BeforeCellCancelUpdate(object sender, Infragistics.Win.UltraWinGrid.CancelableCellEventArgs e)
{

	// 以下のコードは、BeforeCellCancelUpdate を使用すると、
	// セルの編集モードを終了せずにセルの値を 
	// 元の値に戻しますEscape キーが押されると、通常 UltraGrid は編集しているセルの値を
	// 元に戻して、編集モードを終了します編集モードを終了しない
	// 方がいい場合がありますその動作を実装するには、 
	// BeforeCellCancelUpdate イベントを使用します

	// エディターの Value をセルの値に設定しますこれによって値を
	// セルの元の値に戻しますUltraGridCell.Value プロパティは
	// 基本のバインド リストの値を返します
	e.Cell.Column.Editor.Value = e.Cell.Value;

	// Cancel を True に設定すると、編集モードを
	// 終了しません
	e.Cancel = true;

}