TextBox.InputScope Propriété

Définition

Obtient ou définit le contexte de l’entrée utilisée par cette Zone de texte.

C#
public InputScope InputScope { get; set; }
XAML
<TextBox InputScope="inputScopeName" .../>
- or -
<TextBox>
  <TextBox.InputScope>
    <InputScope>
      <InputScope.Names>
        <InputScopeName NameValue="inputScopeName"/>
      </InputScope.Names>
    </InputScope>
  </TextBox.InputScope>
</TextBox>

Valeur de propriété

Étendue d’entrée, qui fournit une indication du type d’entrée de texte attendu par le contrôle. La valeur par défaut est null.

Exemples

Voici comment définir l’InputScope en XAML et dans le code.

XAML
<TextBox Header="Telephone Number" InputScope="TelephoneNumber"/>
C#
TextBox phoneNumberTextBox = new TextBox();
phoneNumberTextBox.Header="Telephone Number";

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

Remarques

L’étendue d’entrée fournit une indication du type d’entrée de texte attendu par le contrôle. Différents éléments du système peuvent répondre à l’indicateur fourni par l’étendue d’entrée et fournir une interface utilisateur spécialisée pour le type d’entrée. Par exemple, le clavier tactile peut afficher un pavé numérique pour l’entrée de texte lorsque son InputScope est défini sur Number. Pour obtenir la liste complète des valeurs d’étendue d’entrée, consultez l’énumération InputScopeNameValue .

Le contrôle peut également interpréter les données entrées différemment (généralement pour les étendues d’entrée liées à l’Asie de l’Est). L’étendue d’entrée n’effectue aucune validation et n’empêche pas l’utilisateur de fournir une entrée par le biais d’un clavier matériel ou d’un autre périphérique d’entrée.

Les autres propriétés qui affectent le clavier tactile sont IsSpellCheckEnabled, IsTextPredictionEnabled et PreventKeyboardDisplayOnProgrammaticFocus. Pour plus d’informations et d’exemples, consultez Utiliser l’étendue d’entrée pour modifier le clavier tactile.

Notes

Bien que cette propriété puisse contenir une collection de valeurs InputScopeName , seule la première est utilisée et le reste est ignoré.

S’applique à

Produit Versions
WinRT Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100

Voir aussi