MaskedTextBox.SkipLiterals Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia wartość wskazującą, czy użytkownik może ponownie wprowadzić wartości literału.
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
Wartość właściwości
true
umożliwianie ponownego przedsiębiorstwa literałów; w przeciwnym razie, false
aby uniemożliwić użytkownikowi zastępowanie znaków literału. Wartość domyślna to true
.
Uwagi
Maski wejściowe często zawierają literały. Gdy użytkownik wprowadza znaki w MaskedTextBox czasie wykonywania, bieżące położenie znaku czasami spadnie na literał. Właściwość SkipLiterals opisuje sposób obsługi danych wejściowych użytkownika dla następnego znaku w następujący sposób:
Jeśli ta właściwość to
true
, użytkownik może albo nadmiarowo wprowadzić ten sam znak, co literał w bieżącej pozycji, lub może wprowadzić następny znak edytowalny, a tym samym przeskoczyć bieżącą pozycję do tej pozycji.Jeśli ta właściwość ma
false
wartość , użytkownik może wprowadzić tylko następny znak edytowalny. Jeśli następne położenie w masce nie zaakceptuje znaku literału (na przykład użytkownik wpisze "/", a następna pozycja akceptuje tylko cyfry), kontrolka zgłosi MaskInputRejected zdarzenie.
Na przykład w masce wprowadzania daty "90/90/0000" znaki ukośnika są literałami. Załóżmy, że użytkownik wprowadził dwie początkowe cyfry "11", więc bieżąca pozycja maski znajduje się w pierwszym literału ukośnika (/). Jeśli SkipLiterals parametr ma true
wartość , użytkownik ma następujące prawidłowe opcje:
Użytkownik może wprowadzić znak "/". Powoduje to przeniesienie pozycji do następnego znaku, który w tym przykładzie jest czwartą pozycją, elementem maskowania 9.
Użytkownik może wprowadzić następny znak edytowalny, który w tym przykładzie jest cyfrą. Cyfra zostanie zweryfikowana, a bieżąca pozycja zostanie automatycznie przeniesiona na piątą pozycję, która jest elementem maskowania 0.
Jeśli SkipLiterals parametr ma false
wartość , dozwolone jest tylko prawidłowe dane wejściowe, co w tym przykładzie będzie cyfrą.