MaskedTextBox.MaskInputRejected イベント

.NET Framework クラス ライブラリ リファレンス

MaskedTextBox.MaskInputRejected イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

ユーザーの入力または割り当てられた文字が、入力マスクの対応する書式要素と一致しない場合に発生します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Event MaskInputRejected As
 MaskInputRejectedEventHandler

Visual Basic (使用法)

Dim instance As MaskedTextBox
Dim handler As MaskInputRejectedEventHandler

AddHandler instance.MaskInputRejected, handler

C#

public event MaskInputRejectedEventHandler MaskInputRejected

C++

public:
event MaskInputRejectedEventHandler^ MaskInputRejected {
    void add (MaskInputRejectedEventHandler^ value);
    void remove (MaskInputRejectedEventHandler^ value);
}

J#

/** @event */
public void add_MaskInputRejected (MaskInputRejectedEventHandler
 value)

/** @event */
public void remove_MaskInputRejected (MaskInputRejectedEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

MaskInputRejected は、MaskedTextBox クラスの既定のイベントです。

MaskInputRejected イベントは、文字が入力マスクで拒否された場合に発生します。入力マスクは Mask プロパティで表され、MaskedTextProvider プロパティを使用してコントロールに関連付けられた、マスクされたテキスト プロバイダによって解釈されます。MaskInputRejected は次のような状況で発生します。

• 入力文字が対応する書式要素と一致しない場合。たとえば、数字が必要なときにユーザーが英字を入力した場合などです。これはおそらく、このイベントが発生する最も一般的な理由です。

• マスクが既にいっぱいになっているか、表示されている入力マスク文字列の末尾に現在のキャレット位置が移動しているのが原因で、ユーザーがマスクの末尾以降に余分な文字を入力しようとしている場合。

• 貼り付け操作により、関連する書式要素と一致しない文字が挿入された場合。または、IsOverwriteMode プロパティが false のときは、既存の文字が書式要素と一致しない新しい位置にシフトされた場合。

• 切り取り操作により既存の文字が左にシフトされ、1 つ以上の文字が、新しく関連付けられた書式要素と一致しない場合。

• Text プロパティへの割り当てが行われ、割り当てられた文字列で 1 つ以上のマスク違反が発生した場合。

MaskInputRejected を発生させるコントロールに文字列が割り当てられている場合、文字列は MaskedTextBox には表示されません。

MaskInputRejected の既定の処理では、BeepOnError プロパティが true に設定されている場合、ビープ音を出します。このイベントは、マスクがいっぱいの場合に次のユーザー入力コントロールに移動したり、入力文字が無効な場合にカスタム エラー ダイアログ ボックスまたはツールヒントを表示したりするなど、カスタム エラー処理を実装するために処理されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
MaskedTextBox クラス
MaskedTextBox メンバ
System.Windows.Forms 名前空間
MaskedTextBox.Text プロパティ
MaskedTextBox.Mask プロパティ
MaskedTextBox.MaskedTextProvider プロパティ
MaskInputRejectedEventArgs
MaskedTextBox.IsOverwriteMode プロパティ
MaskedTextBox.BeepOnError プロパティ