EditModeValidationError イベント

UltraSpreadsheet が編集モードを終了し、ActiveCell の新しい値がセルの Infragistics.Documents.Excel.DataValidationRule の条件に基づいて有効ではない場合に発生されます。

シンタックス

Visual Basic

'宣言
 
Public Event EditModeValidationError As EventHandler(Of SpreadsheetEditModeValidationErrorEventArgs)

C#

public event EventHandler<SpreadsheetEditModeValidationErrorEventArgs> EditModeValidationError

イベント データ

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

プロパティ	解説
Action	失敗した検証に対する応答として実行されたアクションを取得または設定します。
CanStayInEditMode	セルが編集モードを保持することが許可されるかどうかを示すブール値を返します。
Cell	コントロールが編集モードに入ったセルを返します。
ValidationRule	検証が失敗した条件を返します。

解説

編集モードを終了する際に ActiveCell の新しい値がセルの Infragistics.Documents.Excel.DataValidationRule の条件に基づいて有効ではない場合に EditModeValidationError が発生されます。ルールがセルの値およびワークシートのその他のセルの値を評価する必要があるため、値は最初にセルに適用され、その後に検証されます。デフォルトで、イベントが処理されずに Infragistics.Documents.Excel.DataValidationRule.ShowErrorMessageForInvalidValue が true の場合、実行するアクションを決定するためにメッセージ ボックスがエンドユーザーに表示されます。このイベントを処理し、SpreadsheetEditModeValidationErrorEventArgs.Action を使用して実行するアクションを指定できます。

注: Escape または「編集のキャンセル」を押して編集モードをキャンセルすると検証ルールは評価されません。

注:SpreadsheetEditModeValidationErrorEventArgs.ValidationRule の ShowErrorMessageForInvalidValue が false の場合、SpreadsheetEditModeValidationErrorEventArgs.Action のデフォルト値は AcceptChange になります。それ以外の場合、デフォルト値は ShowPrompt になります。

注: Microsoft Excel のように、更新が選択のその他のセルに影響する場合もアクティブなセルの検証ルールが評価されます。