TextBox.InputScope Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Obtient ou définit le contexte d’entrée utilisé par ce TextBox.

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 un indicateur du type d’entrée de texte attendu par le contrôle.

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 un indicateur 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. Consultez l’énumération InputScopeNameValue pour obtenir la liste complète des valeurs d’étendue d’entrée.

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 obtenir plus d’informations et des 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 les autres sont ignorées.

Voir aussi

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