MaskedTextBox.RejectInputOnFirstFailure プロパティ

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

MaskedTextBox.RejectInputOnFirstFailure プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

最初の無効な文字に到達した後、ユーザー入力の解析を停止するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property RejectInputOnFirstFailure As
 Boolean

Visual Basic (使用法)

Dim instance As MaskedTextBox
Dim value As Boolean

value = instance.RejectInputOnFirstFailure

instance.RejectInputOnFirstFailure = value

C#

public bool RejectInputOnFirstFailure { get;
 set; }

C++

public:
property bool RejectInputOnFirstFailure {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_RejectInputOnFirstFailure ()

/** @property */
public void set_RejectInputOnFirstFailure (boolean
 value)

JScript

public function get RejectInputOnFirstFailure
 () : boolean

public function set RejectInputOnFirstFailure
 (value : boolean)

プロパティ値
入力文字列の処理が最初の解析エラーで終了する場合は true。それ以外の場合で、処理がすべてのエラーを無視するときは false。既定値は false です。

解説

ユーザーは、1 回の入力操作で複数の文字を MaskedTextBox に入力することがあります。これが行われるのは、通常は文字列をコピーして貼り付ける場合です。入力マスクの貼り付け位置に従って、文字列全体に有効な文字だけが含まれる場合、操作全体が正常に行われます。ただし、解析エラーが発生した場合、MaskedTextBox の動作は次のように RejectInputOnFirstFailure の値によって異なります。

• このプロパティが true の場合、入力文字列の処理は無効な文字で停止します。後続の文字はすべて無視されます。単一の MaskInputRejected イベントが発生します。

• このプロパティが false に設定されている場合、無効な文字は拒否されますが、入力文字列の次の文字の解析は続行されます。入力文字列の無効な文字ごとに MaskInputRejected イベントが発生します。

ResetOnPrompt、ResetOnSpace、および SkipLiterals の各プロパティも、ユーザー入力の解釈に影響します。

IsOverwriteMode プロパティが false に設定されている場合、挿入位置の右側にある入力マスク内の文字は、受け入れられた文字数分移動します。このシフトにより、追加の解析エラーが発生する可能性があります。

SelectedText プロパティを設定すると、貼り付け操作をプログラムによって模倣できます。

プラットフォーム

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.Mask プロパティ
MaskInputRejected
ResetOnPrompt
ResetOnSpace
MaskedTextBox.IsOverwriteMode プロパティ
SelectedText