MaskedTextBox.ResetOnPrompt プロパティ

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

MaskedTextBox.ResetOnPrompt プロパティ

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

プロンプト文字と一致する入力文字を処理する方法を決定する値を取得または設定します。

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

Visual Basic (宣言)

Public Property ResetOnPrompt As
 Boolean

Visual Basic (使用法)

Dim instance As MaskedTextBox
Dim value As Boolean

value = instance.ResetOnPrompt

instance.ResetOnPrompt = value

C#

public bool ResetOnPrompt { get;
 set; }

C++

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

J#

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

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

JScript

public function get ResetOnPrompt
 () : boolean

public function set ResetOnPrompt
 (value : boolean)

プロパティ値
入力されたプロンプト文字によって、マスク内の現在の編集可能な位置がリセットされる場合は true。それ以外の場合、プロンプト文字が通常の入力文字として処理されることを示すには false。既定値は true です。

解説

MaskedTextBox は、空白とプロンプト文字の 2 つの文字カテゴリを特別に処理できます。通常、各入力文字はマスクに対してテストされ、受け入れられるか拒否されます。PromptChar プロパティが null 参照 (Visual Basic では Nothing) 以外に設定されている場合、ResetOnPrompt プロパティを true に設定すると、プロンプト文字に対して特別な処理が行われます。ユーザーがマスクにプロンプト文字を入力すると、現在のマスク文字の位置が解除され、現在の位置が次の編集可能な文字に進みます。

次の表に示すように、ResetOnPrompt は AllowPromptAsInput プロパティよりも優先されます。

ResetOnPrompt 値	AllowPromptAsInput 値	結果の動作
true	true	プロンプト文字を入力できます。現在のマスク位置がリセットされます。これは、既定の設定です。
true	false	プロンプト文字を入力できます。現在のマスク位置がリセットされます。
false	true	プロンプト文字は、標準の入力文字として処理されます。
false	false	プロンプト文字は無効で、MaskInputRejected イベントを発生させます。

プラットフォーム

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.PromptChar プロパティ
MaskedTextBox.AllowPromptAsInput プロパティ
MaskedTextBox.HidePromptOnLeave プロパティ
ResetOnSpace