MaskedTextProvider.ResetOnPrompt Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur qui détermine comment un caractère d'entrée qui correspond au caractère d'invite doit être géré.
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
Valeur de propriété
true
si le fait de saisir le caractère d'invite comme entrée entraîne la réinitialisation de la position modifiable actuelle dans le masque ; sinon, false
pour indiquer que le caractère d'invite sera traité comme un caractère d'entrée normal. La valeur par défaut est true
.
Remarques
MaskedTextProvider peut traiter deux catégories de caractères, les caractères d’allure et les caractères d’invite, d’une manière spéciale. Normalement, chaque caractère d’entrée est testé par rapport au masque et accepté ou rejeté. En supposant que la PromptChar propriété est définie sur une valeur autre que null
, la définition de la ResetOnPrompt propriété true
sur entraîne un traitement spécial pour le caractère d’invite. Lorsqu’un caractère d’invite est ajouté, la position actuelle du caractère du masque est effacée et la position actuelle est avancée vers le caractère modifiable suivant.
ResetOnPrompt est prioritaire sur la AllowPromptAsInput propriété, comme décrit dans le tableau suivant.
ResetOnPrompt | AllowPromptAsInput | Comportement résultant |
---|---|---|
true |
true |
Le caractère d’invite peut être ajouté et entraîne la réinitialisation de la position actuelle du masque. Valeur par défaut. |
true |
false |
Le caractère d’invite peut être ajouté et entraîne la réinitialisation de la position actuelle du masque. |
false |
true |
Le caractère d’invite est traité comme un caractère d’entrée normal. |
false |
false |
Le caractère d’invite n’est pas valide et les méthodes qui tentent d’ajouter le caractère échouent. |