MaskedTextBox.ResetOnPrompt Propriedade

  • Referência

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.

Aplica-se a

Confira também