ValidationError イベント (UltraNumericEditorBase)

無効なValueを持つコントロールがフォーカスを失ったときに発生します。

シンタックス

Visual Basic

'宣言
 
Public Event ValidationError As UltraNumericEditorBase.ValidationErrorEventHandler

C#

public event UltraNumericEditorBase.ValidationErrorEventHandler ValidationError

イベント データ

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

プロパティ	解説
Beep
InvalidText
LastValidValue
RetainFocus

解説

ValidationError イベントは、コントロールが無効な値でフォーカスを失った時のコントロールの反応方法をカスタマイズする機能を提供します。

Infragistics.Win.UltraWinEditors.ValidationErrorEventArgs クラスは、これを行うために以下のプロパティを公開します。

• Infragistics.Win.UltraWinEditors.ValidationErrorEventArgs.Beep: False に設定すると、無効な値でフォーカスを失った時にコントロールがビープ音を発することを防止します。デフォルト値は Trueです。
• Infragistics.Win.UltraWinEditors.ValidationErrorEventArgs.RetainFocus: True に設定すると、有効値が入力されるまでコントロールは入力フォーカスを保持します。このプロパティは、False に設定して発生を防止できます。デフォルト値は Trueです。
• Infragistics.Win.UltraWinEditors.ValidationErrorEventArgs.LastValidValue: コントロールによって保持された最終の有効値を含みます。ユーザー フィードバックを提供するために有用で、コントロールを有効な状態にします。

使用例

Visual Basic

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinEditors

    Private Sub UltraNumericEditor1_ValidationError(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinEditors.ValidationErrorEventArgs) Handles UltraNumericEditor1.ValidationError
        '	Set the Beep property to false to prevent the system beep
        '	sound from being generated when there is a validation error
        e.Beep = False

        '	Set the RetainFocus property to false so we don't
        '	keep the focus when there is a validation error
        e.RetainFocus = False

        '	Restore the last valid value
        Me.UltraNumericEditor1.Value = e.LastValidValue

    End Sub

C#

using System.Diagnostics;
using Infragistics.Win;
using Infragistics.Win.UltraWinEditors;

		private void ultraNumericEditor1_ValidationError(object sender, Infragistics.Win.UltraWinEditors.ValidationErrorEventArgs e)
		{
			//	Set the Beep property to false to prevent the system beep
			//	sound from being generated when there is a validation error
			e.Beep = false;

			//	Set the RetainFocus property to false so we don't
			//	keep the focus when there is a validation error
			e.RetainFocus = false;

			//	Restore the last valid value
			this.ultraNumericEditor1.Value = e.LastValidValue;
		}