MaskedTextBox.SkipLiterals プロパティ

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

MaskedTextBox.SkipLiterals プロパティ

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

ユーザーがリテラル値の再入力を許可されているかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property SkipLiterals As
 Boolean

Visual Basic (使用法)

Dim instance As MaskedTextBox
Dim value As Boolean

value = instance.SkipLiterals

instance.SkipLiterals = value

C#

public bool SkipLiterals { get;
 set; }

C++

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

J#

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

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

JScript

public function get SkipLiterals
 () : boolean

public function set SkipLiterals
 (value : boolean)

プロパティ値
リテラルの再入力が許可されている場合は true。それ以外の場合、ユーザーがリテラル文字を上書きできないときは false。既定値は true です。

解説

通常、入力マスクにはリテラルが含まれます。ユーザーが実行時に MaskedTextBox に文字を入力すると、現在の文字の位置がリテラルになることがあります。SkipLiterals プロパティは、次の文字のユーザー入力がどのように処理されるかを示します。この例を次に示します。

• このプロパティが true の場合、ユーザーは現在の位置にリテラルと同じ文字を重複して入力できるか、次の編集可能な文字を入力できるため、現在の位置がその位置にジャンプします。

• このプロパティが false の場合、ユーザーは次の編集可能な文字だけを入力できます。マスク内の次の位置でリテラル文字が禁止されている場合 (ユーザーが "/" を入力して、次の位置が数字だけを受け入れる場合など)、コントロールは MaskInputRejected イベントを発生させます。

たとえば、"90/90/0000" という日付エントリ マスクでは、スラッシュ文字がリテラルです。ユーザーが最初の 2 つの数字 ("11") を入力し、マスク内の現在の位置は最初のスラッシュ (/) であり、リテラルであるとします。SkipLiterals が true の場合、有効な選択肢は次のとおりです。

• ユーザーは "/" 文字を入力できます。これにより、次の文字に位置を移動できます。この例では、4 番目の位置、つまりマスク要素 9 です。

• ユーザーは、次の編集可能な文字を入力できます。この例では数字です。数字が検証され、現在の位置が 5 番目の位置に自動的に移動します。この例では、マスク要素 0 です。

SkipLiterals が false の場合、有効なデータ入力だけが許可されます。この例では、数字になります。

プラットフォーム

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 名前空間
MaskInputRejected