Utiliser la plage de saisie pour modifier le clavier tactile

Pour aider les utilisateurs à entrer des données à l’aide du clavier tactile ou du panneau d’entrée réversible (SIP), vous pouvez définir l’étendue d’entrée du contrôle de texte pour qu’elle corresponde au type de données que l’utilisateur doit entrer.

API importantes

• PortéeD'entrée
• NomValeurPortéeD'entrée

Le clavier tactile peut être utilisé pour l’entrée de texte lorsque votre application s’exécute sur un appareil avec un écran tactile. Le clavier tactile est appelé lorsque l’utilisateur appuie sur un champ d’entrée modifiable, tel qu’un TextBox ou RichEditBox. Vous pouvez rendre plus rapide et plus facile pour les utilisateurs d’entrer des données dans votre application en définissant l’étendue d’entrée du contrôle de texte pour qu’elle corresponde au type de données que vous attendez de l’utilisateur. L’étendue d’entrée fournit un indicateur au système sur le type d’entrée de texte attendu par le contrôle afin que le système puisse fournir une disposition de clavier tactile spécialisée pour le type d’entrée.

Par exemple, si une zone de texte est utilisée uniquement pour entrer un code confidentiel à 4 chiffres, définissez la propriété InputScope sur Number. Cela indique au système d’afficher la disposition du pavé numérique, facilitant ainsi la saisie du code PIN par l'utilisateur.

Changement de la portée d'entrée d’un contrôle de texte

Les étendues d’entrée disponibles pour votre application sont membres de l’énumération InputScopeNameValue . Vous pouvez définir la propriété InputScope d'une TextBox ou RichEditBox sur l’une de ces valeurs.

Ici, vous modifiez l’étendue d’entrée de plusieurs zones de texte pour qu’elles correspondent aux données attendues pour chaque zone de texte.

Pour modifier la zone de saisie dans XAML

1. Dans le fichier XAML de votre page, recherchez la balise du contrôle de texte que vous souhaitez modifier.

2. Ajoutez l’attribut InputScope à la balise et spécifiez la valeur InputScopeNameValue qui correspond à l’entrée attendue.

   Voici quelques zones de texte qui peuvent apparaître sur un formulaire de contact client commun. Avec la InputScope définie, un clavier tactile avec une disposition appropriée pour les données s’affiche pour chaque zone de texte.

   <StackPanel Width="300">
       <TextBox Header="Name" InputScope="Default"/>
       <TextBox Header="Email Address" InputScope="EmailSmtpAddress"/>
       <TextBox Header="Telephone Number" InputScope="TelephoneNumber"/>
       <TextBox Header="Web site" InputScope="Url"/>
   </StackPanel>
   

Pour changer la portée d'entrée dans le code

1. Dans le fichier XAML de votre page, recherchez la balise du contrôle de texte que vous souhaitez modifier. S’il n’est pas défini, définissez l' d’attribut x :Name pour référencer le contrôle dans votre code.

   <TextBox Header="Telephone Number" x:Name="phoneNumberTextBox"/>
   

2. Instanciez un nouvel objet InputScope .

   InputScope scope = new InputScope();
   

3. Instanciez un nouvel objet InputScopeName .

   InputScopeName scopeName = new InputScopeName();
   

4. Définissez la propriété NameValue de l'objet InputScopeName sur la valeur de l'énumération InputScopeNameValue.

   scopeName.NameValue = InputScopeNameValue.TelephoneNumber;
   

5. Ajoutez l'objet InputScopeName à la collection Names de l'objet InputScope.

   scope.Names.Add(scopeName);
   

6. Définissez l’objet comme valeur de la propriété InputScope du contrôle de texte.

   phoneNumberTextBox.InputScope = scope;
   

Voici l'ensemble du code.

InputScope scope = new InputScope();
InputScopeName scopeName = new InputScopeName();
scopeName.NameValue = InputScopeNameValue.TelephoneNumber;
scope.Names.Add(scopeName);
phoneNumberTextBox.InputScope = scope;

Les mêmes étapes peuvent être condensées dans ce code abrégé.

phoneNumberTextBox.InputScope = new InputScope() 
{
    Names = {new InputScopeName(InputScopeNameValue.TelephoneNumber)}
};

Prédiction de texte, vérification orthographique et correction automatique

Les contrôles TextBox et RichEditBox ont plusieurs propriétés qui influencent le comportement du protocole SIP. Pour offrir la meilleure expérience à vos utilisateurs, il est important de comprendre comment ces propriétés affectent l’entrée de texte à l’aide de l’interaction tactile.

• IsSpellCheckEnabled : lorsque la vérification orthographique est activée pour un contrôle de texte, le contrôle interagit avec le moteur de vérification orthographique du système pour marquer les mots qui ne sont pas reconnus. Vous pouvez appuyer sur un mot pour afficher la liste des corrections suggérées. La vérification orthographique est activée par défaut.

  Pour l'étendue d’entrée par défaut , cette propriété active également la mise en majuscule automatique du premier mot d'une phrase et la correction automatique des mots pendant la saisie. Ces fonctionnalités de correction automatique peuvent être désactivées dans d’autres étendues d’entrée. Pour plus d’informations, consultez les tableaux plus loin dans cette rubrique.

• IsTextPredictionEnabled : lorsque la prédiction de texte est activée pour un contrôle de texte, le système affiche une liste de mots que vous commencez peut-être à taper. Vous pouvez sélectionner dans la liste pour ne pas avoir à taper le mot entier. La prédiction de texte est activée par défaut.

  La prédiction de texte peut être désactivée si l’étendue d’entrée est autre que Default, même si la propriété IsTextPredictionEnabled a la valeur true. Pour plus d’informations, consultez les tableaux plus loin dans cette rubrique.

• PreventKeyboardDisplayOnProgrammaticFocus: lorsque cette propriété est true, elle empêche le système d’afficher le protocole SIP lorsque le focus est défini par programme sur un contrôle de texte. Au lieu de cela, le clavier est affiché uniquement lorsque l’utilisateur interagit avec le contrôle.

Index clavier tactile pour Windows

Ces tableaux affichent les dispositions du panneau d'entrée tactile Windows (SIP) pour les valeurs d'étendue d'entrée courantes. L’effet de l’étendue d’entrée sur les fonctionnalités activées par les propriétés IsSpellCheckEnabled et IsTextPredictionEnabled est répertorié pour chaque étendue d’entrée. Il ne s’agit pas d’une liste complète des étendues d’entrée disponibles.

Par défaut

<TextBox InputScope="Default"/>

Clavier tactile Windows par défaut.

• Vérification orthographique : activée si IsSpellCheckEnabled = true, désactivée si IsSpellCheckEnabled = false
• Correction automatique : activée si IsSpellCheckEnabled = vrai, désactivée si IsSpellCheckEnabled = faux
• Paramètre de mise en majuscule automatique : activé si IsSpellCheckEnabled = true, désactivé si IsSpellCheckEnabled = false
• Prédiction de texte : activée si IsTextPredictionEnabled = true, désactivée si IsTextPredictionEnabled = false

MontantEtSymboleDeDevise

<TextBox InputScope="CurrencyAmountAndSymbol"/>

La disposition par défaut du clavier pour les nombres et les symboles.

monétaires

• Inclut les touches de gauche/droite de la page pour afficher d’autres symboles
• Vérification orthographique : activée par défaut, peut être désactivée
• Correction automatique : activée par défaut, peut être désactivée
• Mise en majuscule automatique : toujours désactivée
• Prédiction de texte : activée par défaut, peut être désactivée

URL

<TextBox InputScope="Url"/>

• Inclut les touches .com et (Go). Appuyez longuement sur la touche .com pour afficher des options supplémentaires (suffixes spécifiques à la région, .org, .net)
• Inclut les touches ,, -et la clé /
• Vérification orthographique : désactivée par défaut, peut être activée
• Correction automatique : désactivée par défaut, peut être activée
• Mise en majuscule automatique : désactivée par défaut, peut être activée
• Prédiction de texte : désactivée par défaut, peut être activée

AdresseSmtpEmail

<TextBox InputScope="EmailSmtpAddress"/>

• Inclut les clés @ et .com. Appuyez longuement sur la touche .com pour afficher des options supplémentaires (suffixes spécifiques à la région, .org, .net)
• Inclut le _ et les - clés
• Vérification orthographique : désactivée par défaut, peut être activée
• Correction automatique : désactivée par défaut, peut être activée
• Mise en majuscule automatique : désactivée par défaut, peut être activée
• Prédiction de texte : désactivée par défaut, peut être activée

Number

<TextBox InputScope="Number"/>

• Vérification orthographique : activée par défaut, peut être désactivée
• Correction automatique : activée par défaut, peut être désactivée
• Mise en majuscule automatique : toujours désactivée
• Prédiction de texte : activée par défaut, peut être désactivée

Numéro de téléphone

<TextBox InputScope="TelephoneNumber"/>

• Vérification orthographique : activée par défaut, peut être désactivée
• Correction automatique : activée par défaut, peut être désactivée
• Mise en majuscule automatique : toujours désactivée
• Prédiction de texte : activée par défaut, peut être désactivée

Rechercher

<TextBox InputScope="Search"/>

• Inclut la touche de recherche au lieu de la touche Entrée
• Vérification orthographique : activée par défaut, peut être désactivée
• Correction automatique : activée par défaut, peut être désactivée
• Mise en majuscule automatique : toujours désactivée
• Prédiction de texte : activée par défaut, peut être désactivée

SearchIncremental

<TextBox InputScope="SearchIncremental"/>

• Même disposition que par défaut
• Vérification orthographique : désactivée par défaut, peut être activée
• Correction automatique : toujours désactivé
• Mise en majuscule automatique : toujours désactivée
• Prédiction de texte : toujours désactivé

Formula

<TextBox InputScope="Formula"/>

de formule

• Inclut la = clé
• Inclut également les touches %, $ et +
• Vérification orthographique : activée par défaut, peut être désactivée
• Correction automatique : activée par défaut, peut être désactivée
• Mise en majuscule automatique : toujours désactivée
• Prédiction de texte : activée par défaut, peut être désactivée

Chat

<TextBox InputScope="Chat"/>

• Même disposition que par défaut
• Vérification orthographique : activée par défaut, peut être désactivée
• Correction automatique : activée par défaut, peut être désactivée
• Mise en majuscule automatique : activée par défaut, peut être désactivée
• Prédiction de texte : activée par défaut, peut être désactivée

NomOuNuméroDeTéléphone

<TextBox InputScope="NameOrPhoneNumber"/>

• Même disposition que par défaut
• Vérification orthographique : désactivée par défaut, peut être activée
• Correction automatique : désactivée par défaut, peut être activée
• Mise en majuscule automatique : désactivée par défaut, peut être activée (la première lettre de chaque mot est majuscule)
• Prédiction de texte : désactivée par défaut, peut être activée