MaskedTextBox.ResetOnPrompt Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define um valor que determina como um caractere de entrada que corresponde ao caractere do prompt deve ser tratado.

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 da propriedade

Boolean

true se o caractere de prompt inserido como entrada fizer com que a posição editável atual na máscara seja redefinida, caso contrário, false para indicar que ele deverá ser processado como um caractere de entrada normal. O padrão é true.

Comentários

O MaskedTextBox pode tratar duas categorias de caracteres - espaços e caracteres de prompt - especialmente. Normalmente, cada caractere de entrada será testado na máscara e aceito ou rejeitado. Supondo que a PromptChar propriedade seja definida como nãonull e, em seguida, definir a ResetOnPrompt propriedade como true resultará em processamento especial para o caractere de prompt. Quando o usuário insere o caractere de prompt na máscara, ele faz com que a posição atual do caractere de máscara seja desmarcada e a posição atual seja avançada para o próximo caractere editável.

ResetOnPrompt tem precedência sobre a AllowPromptAsInput propriedade , conforme mostrado na tabela a seguir.

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

Confira também

• PromptChar
• AllowPromptAsInput
• HidePromptOnLeave
• ResetOnSpace