Udostępnij za pośrednictwem


MaskedTextBox.SkipLiterals Właściwość

Definicja

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 falsewartość , 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 truewartość , 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 falsewartość , dozwolone jest tylko prawidłowe dane wejściowe, co w tym przykładzie będzie cyfrą.

Dotyczy

Zobacz też