MaskedTextBox.SkipLiterals Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

MaskedTextBox.cs

Obtém ou define um valor que indica se o usuário tem permissão para reentrada em 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 literais sejam reentrados; caso contrário, false para impedir que o usuário substitua caracteres literais. O padrão é true.

Comentários

Máscaras de entrada geralmente contêm literais. Quando o usuário insere caracteres MaskedTextBox no 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 com redundância o mesmo caractere que o literal na posição atual ou pode inserir o próximo caractere editável, saltando 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 para frente são literais. Suponha que o usuário inseriu dois dígitos iniciais, "11", de modo que a posição atual na máscara esteja na primeira barra (/) literal. Se SkipLiterals estiver 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 máscara 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, apenas uma entrada de dados válida é permitida, o que neste exemplo seria um dígito.

Confira também

• MaskInputRejected