MaskedTextProvider.ResetOnPrompt プロパティ

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

MaskedTextProvider.ResetOnPrompt プロパティ

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

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

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Property ResetOnPrompt As
 Boolean

Visual Basic (使用法)

Dim instance As MaskedTextProvider
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 です。

解説

MaskedTextProvider は、特別な方法で文字の 2 つのカテゴリ (空白とプロンプト文字) を扱うことができます。通常、各入力文字はマスクに対してテストされ、受け入れられるか拒否されます。PromptChar プロパティに null 参照 (Visual Basic では Nothing) 以外の値が設定されているという前提で、ResetOnPrompt プロパティに true を設定すると、プロンプト文字に対して特別な処理が行われます。プロンプト文字を追加すると、現在のマスク文字位置が消去され、現在の位置が次の編集可能な文字まで進められます。

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

ResetOnPrompt	AllowPromptAsInput	結果として生じる動作
true	true	プロンプト文字を追加でき、プロンプト文字によって現在のマスク位置をリセットします。既定値です。
true	false	プロンプト文字を追加でき、プロンプト文字によって現在のマスク位置をリセットします。
false	true	プロンプト文字は、通常の入力文字として処理されます。
false	false	プロンプト文字は有効ではないため、文字を追加しようとするメソッドは失敗します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
MaskedTextProvider クラス
MaskedTextProvider メンバ
System.ComponentModel 名前空間
MaskedTextBox.ResetOnPrompt
MaskedTextProvider.AllowPromptAsInput プロパティ
ResetOnSpace
SkipLiterals
MaskedTextProvider.IncludePrompt プロパティ
MaskedTextProvider.PromptChar プロパティ
Add
Clear