MaskedTextBox.SkipLiterals Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá nebo nastaví hodnotu označující, zda je uživateli povoleno znovu zadat hodnoty literálů.

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

Hodnota vlastnosti

Boolean

true aby bylo možné znovu zadat literály; jinak, false aby uživatel nepřepsal literálové znaky. Výchozí formát je true.

Poznámky

Vstupní masky obvykle obsahují literály. Když uživatel zadává znaky do MaskedTextBox za běhu, aktuální pozice znaku někdy spadá do literálu. Vlastnost SkipLiterals popisuje, jak se má uživatelský vstup pro další znak zpracovat, a to následujícím způsobem:

• Pokud je truetato vlastnost , uživatel může buď nadbytečně zadat stejný znak jako literál na aktuální pozici, nebo může zadat další upravitelný znak, čímž přeskočí aktuální pozici na tuto pozici.

• Pokud je falsetato vlastnost , uživatel může zadat pouze další upravitelný znak. Pokud další pozice v masce nepřijme literál (například uživatel zadá "/" a další pozice přijímá pouze číslice), ovládací prvek vyvolá MaskInputRejected událost.

Například v maskě data "90/90/0000" jsou znaky lomítka literály. Předpokládejme, že uživatel zadal dvě počáteční číslice, "11", takže aktuální pozice v masce je u prvního lomítka (/) literálu. Pokud SkipLiterals je true, má uživatel následující platné možnosti:

• Uživatel může zadat znak "/". Výsledkem je přesunutí pozice na další znak, což je v tomto příkladu čtvrtá pozice, prvek maskování 9.

• Uživatel může zadat další upravitelný znak, což je v tomto příkladu číslice. Číslice by byla ověřena a aktuální pozice by se automaticky přesunula na pátou pozici, což je prvek maskování 0.

Pokud SkipLiterals je false, je povolený pouze platný datový vstup, což by v tomto příkladu byla číslice.

Viz také

• MaskInputRejected