MaskedTextBox.SkipLiterals Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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, set
Public Property SkipLiterals As Boolean

Valor da propriedade

Boolean

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.

Aplica-se a

Confira também