TextBox.InputScope Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls

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

public:
 property InputScope ^ InputScope { InputScope ^ get(); void set(InputScope ^ value); };

InputScope InputScope();

void InputScope(InputScope value);

public InputScope InputScope { get; set; }

var inputScope = textBox.inputScope;
textBox.inputScope = inputScope;

Public Property InputScope As InputScope

<TextBox InputScope="inputScopeName" .../>
- or -
<TextBox>
  <TextBox.InputScope>
    <InputScope>
      <InputScope.Names>
        <InputScopeName NameValue="inputScopeName"/>
      </InputScope.Names>
    </InputScope>
  </TextBox.InputScope>
</TextBox>

Valeur de propriété

InputScope

É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.

<TextBox Header="Telephone Number" InputScope="TelephoneNumber"/>

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é.

Voir aussi

• IsSpellCheckEnabledProperty
• IsTextPredictionEnabledProperty
• InputScopeNameValue
• Utiliser l’étendue des entrées pour modifier le clavier tactile