MaskedTextBox.SkipLiterals Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu označující, zda uživatel může znovu zadat hodnoty literálu.
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 BooleanHodnota vlastnosti
true aby byly literály znovu provázeny; jinak zabráníte false uživateli v přepsání literálových znaků. Výchozí hodnota je true.
Poznámky
Vstupní masky obvykle obsahují literály. Když uživatel zadává znaky do MaskedTextBox modulu runtime, pozice aktuálního znaku někdy spadá do literálu. Vlastnost SkipLiterals popisuje, jak se má zpracovat uživatelský vstup pro další znak, a to následujícím způsobem:
Pokud je
truetato vlastnost , uživatel může buď redundantně 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álový znak (například uživatel zadá "/" a další pozice přijímá pouze číslice), ovládací prvek vyvolá MaskInputRejected událost.
Například v maskě položky kalendářního data "90.90.9000" 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 na prvním dopředném lomítku (/) literálu. Pokud SkipLiterals ano true, uživatel má následující platné volby:
Uživatel může zadat znak /. Výsledkem je přesunutí pozice na další znak, který je v tomto příkladu čtvrtým prvkem 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 0 maskovací prvek.
Pokud SkipLiterals ano false, pak je povolen pouze platný vstup dat, který v tomto příkladu by byl číslice.
