TextBox.InputScope 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 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é
É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é.