MaskedTextBox.SkipLiterals Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se o utilizador pode reintroduzir 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 de Propriedade
true permitir que literais fossem reintroduzidos; caso contrário, false para evitar que o utilizador sobrescrita caracteres literais. A predefinição é true.
Observações
As máscaras de entrada normalmente contêm literais. Quando o utilizador insere caracteres no MaskedTextBox tempo de execução at, a posição atual do carácter por vezes corresponde a um literal. A SkipLiterals propriedade descreve como a entrada do utilizador para o próximo carácter deve ser tratada, da seguinte forma:
Se esta propriedade for
true, o utilizador pode inserir redundantemente o mesmo carácter que o literal na posição atual, ou pode inserir o próximo carácter editável, saltando assim a posição atual para essa posição.Se esta propriedade for
false, o utilizador só pode inserir o próximo carácter editável. Se a posição seguinte na máscara não aceitar o carácter literal (por exemplo, o utilizador digitar "/" e a posição seguinte só aceitar dígitos), o controlo irá aumentar o MaskInputRejected evento.
Por exemplo, na máscara de entrada de data "90/90/0000", os caracteres de barra frontal são literais. Assuma que o utilizador introduziu dois dígitos iniciais, "11", de modo que a posição atual na máscara está na primeira barra lateral (/) literal. Se SkipLiterals for true, então o utilizador tem as seguintes escolhas válidas:
O utilizador pode introduzir um carácter "/". Isto faz com que a posição seja movida para o carácter seguinte, que neste exemplo é a quarta posição, um elemento de máscara 9.
O utilizador pode introduzir o próximo carácter editável, que neste exemplo é um dígito. O dígito seria validado e a posição atual seria automaticamente movida para a quinta posição, que é um elemento de mascaramento 0.
Se SkipLiterals for false, então apenas uma entrada de dados válida é permitida, que neste exemplo seria um dígito.
