MaskedTextBox.SkipLiterals プロパティ

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

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

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

public bool SkipLiterals { get; set; }

member this.SkipLiterals : bool with get, set

Public Property SkipLiterals As Boolean

プロパティ値

Boolean

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

注釈

入力マスクには一般的にリテラルが含まれます。 ユーザーが実行時に MaskedTextBox に文字を入力すると、現在の文字位置がリテラルに当たることがあります。 プロパティは SkipLiterals 、次のように、次の文字のユーザー入力を処理する方法を説明します。

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

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

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

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

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

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

こちらもご覧ください

• MaskInputRejected