MaskedTextBox.SkipLiterals Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se o usuário pode inserir novamente valores literais.
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 BooleanValor da propriedade
true para permitir que os literais sejam reinseridos; caso contrário, false para impedir que o usuário faça substituição de caracteres literais. O padrão é true.
Comentários
Máscaras de entrada geralmente contêm literais. Quando o usuário insere caracteres no MaskedTextBox em runtime, a posição do caractere atual às vezes cairá em um literal. A SkipLiterals propriedade descreve como a entrada do usuário para o próximo caractere deve ser tratada, da seguinte maneira:
Se essa propriedade for
true, o usuário poderá inserir redundantemente o mesmo caractere que o literal na posição atual ou pode inserir o próximo caractere editável, pulando assim a posição atual para essa posição.Se essa propriedade for
false, o usuário só poderá inserir o próximo caractere editável. Se a próxima posição na máscara não aceitar o caractere literal (por exemplo, o usuário digita "/" e a próxima posição aceita apenas dígitos), o controle acionará o MaskInputRejected evento.
Por exemplo, na máscara de entrada de data "90/90/0000", os caracteres de barra de avanço são literais. Suponha que o usuário tenha inserido dois dígitos iniciais, "11", portanto, a posição atual na máscara está na primeira barra (/) literal. Se SkipLiterals for true, o usuário terá as seguintes opções válidas:
O usuário pode inserir um caractere "/". Isso faz com que a posição seja movida para o próximo caractere, que neste exemplo é a quarta posição, um elemento de mascaramento 9.
O usuário pode inserir o próximo caractere editável, que neste exemplo é um dígito. O dígito seria validado e a posição atual seria movida automaticamente para a quinta posição, que é um elemento de mascaramento 0.
Se SkipLiterals for false, somente uma entrada de dados válida será permitida, o que neste exemplo seria um dígito.
