MaskedTextBox.SkipLiterals プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザーがリテラル値の再入力を許可されているかどうかを示す値を取得または設定します。
public:
property bool SkipLiterals { bool get(); void set(bool value); };public bool SkipLiterals { get; set; }member this.SkipLiterals : bool with get, setPublic Property SkipLiterals As Booleanプロパティ値
リテラルの再入力が許可されている場合は true。それ以外の場合、ユーザーがリテラル文字を上書きできないときは false。 既定値は、true です。
注釈
入力マスクには、一般的にリテラルが含まれます。 ユーザーが実行時に文字を MaskedTextBox 入力すると、現在の文字位置がリテラルに当たることがあります。 このプロパティでは SkipLiterals 、次の文字のユーザー入力を次のように処理する方法について説明します。
このプロパティの場合、ユーザーは
trueリテラルと同じ文字を現在の位置に冗長的に入力するか、次の編集可能な文字を入力して現在位置をその位置にジャンプさせることができます。このプロパティの場合、ユーザーは
false次の編集可能な文字のみを入力できます。 マスク内の次の位置がリテラル文字を受け入れられない場合 (たとえば、ユーザーが "/" を入力し、次の位置は数字のみを受け入れます)、コントロールはイベントを MaskInputRejected 発生させます。
たとえば、"90/90/0000" 日付エントリ マスクでは、スラッシュ文字はリテラルです。 ユーザーが 2 桁の最初の数字 "11" を入力したので、マスク内の現在の位置が最初のスラッシュ (/) リテラルにあるとします。 ある場合 SkipLiterals 、 trueユーザーには次の有効な選択肢があります。
ユーザーは "/" 文字を入力できます。 これにより、位置が次の文字に移動されます。この例では、4 番目の位置である 9 個のマスク要素です。
ユーザーは次の編集可能な文字を入力できます。この例では数字です。 数字は検証され、現在位置は自動的に 0 マスク要素である 5 番目の位置に移動されます。
ある場合 SkipLiterals は false、有効なデータ入力のみが許可されます。この例では数字になります。