'宣言 Public Event BeforeCellCancelUpdate As CancelableCellEventHandler
public event CancelableCellEventHandler BeforeCellCancelUpdate
イベント ハンドラが、このイベントに関連するデータを含む、CancelableCellEventArgs 型の引数を受け取りました。次の CancelableCellEventArgs プロパティには、このイベントの固有の情報が記載されます。
プロパティ | 解説 |
---|---|
Cancel System.ComponentModel.CancelEventArgsから継承されます。 | |
Cell | 対象となるセルへの参照を返します。 |
cell 引数は、更新がキャンセルされようとするセルのプロパティの設定やそのメソッドの呼び出しに使用できる、UltraGridCell オブジェクトへの参照を返します。この参照を使用して、返されるセルのプロパティまたはメソッドにアクセスできます。
cancel 引数を使用して、セルの更新がキャンセルされないようにプログラミングできます。この引数を使用すると、一定の条件が満たされないかぎり、ユーザーが更新をキャンセルできないようにすることができます。
このイベントは、ユーザーが [Esc] キーを押してセルの値の変更をキャンセルした時に生成されます。CancelUpdate メソッドが呼び出された場合は生成されません。
AfterCellCancelUpdate イベントは、 cancel が True に設定されず、セルの更新がキャンセルされた後(このイベントの後)に発生します。
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
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; }