MaskedTextBox.ResetOnPrompt Propriedade

Definição

Recebe ou define um valor que determina como deve ser tratado um carácter de entrada que corresponde ao carácter de prompt.

public:
 property bool ResetOnPrompt { bool get(); void set(bool value); };
public bool ResetOnPrompt { get; set; }
member this.ResetOnPrompt : bool with get, set
Public Property ResetOnPrompt As Boolean

Valor de Propriedade

true se o carácter de prompt introduzido como entrada fizer com que a posição editável atual na máscara seja reiniciada; caso contrário, false indicar que o carácter de prompt deve ser processado como um carácter de entrada normal. A predefinição é true.

Observações

Podem MaskedTextBox tratar duas categorias de personagens – espaços e personagens de prompt – de forma especial. Normalmente, cada carácter de entrada é testado contra a máscara e aceite ou rejeitado. Assumindo que a PromptChar propriedade está definida como não-null, então definir a ResetOnPrompt propriedade para true resultará num processamento especial para o carácter de prompt. Quando o utilizador insere o carácter de prompt na máscara, isso faz com que a posição atual do carácter da máscara seja apagada e a posição atual seja avançada para o próximo carácter editável.

ResetOnPrompt tem precedência sobre a AllowPromptAsInput propriedade, como mostrado na tabela seguinte.

Valor ResetOnPrompt Valor AllowPromptAsInput Comportamento resultante
true true O carácter de prompt pode ser introduzido e faz com que a posição atual da máscara seja reiniciada. Este é o padrão.
true false O carácter de prompt pode ser introduzido e faz com que a posição atual da máscara seja reiniciada.
false true O carácter de prompt é processado como um carácter de entrada padrão.
false false O carácter de prompt não é válido e levanta um MaskInputRejected evento.

Aplica-se a

Ver também