TextBox.InputScope Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Ottiene o imposta il contesto per l'input usato da 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>

Valore della proprietà

InputScope

Ambito di input, che fornisce un hint per il tipo di input di testo previsto dal controllo.

Esempio

Ecco come impostare InputScope in XAML e nel codice.

<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;

Commenti

L'ambito di input fornisce un suggerimento al tipo di input di testo previsto dal controllo. Vari elementi del sistema possono rispondere all'hint fornito dall'ambito di input e fornire un'interfaccia utente specializzata per il tipo di input. Ad esempio, la tastiera tocco potrebbe visualizzare un riquadro numeri per l'input di testo quando il controllo ha il relativo InputScope impostato su Number. Per un elenco completo di valori di ambito di input, vedere l'enumerazione InputScopeNameValue .

Il controllo può anche interpretare i dati immessi in modo diverso (in genere per gli ambiti di input correlati all'Asia orientale). L'ambito di input non esegue alcuna convalida e non impedisce all'utente di fornire alcun input tramite una tastiera hardware o un altro dispositivo di input.

Le altre proprietà che influiscono sulla tastiera virtuale sono IsSpellCheckEnabled, IsTextPredictionEnabled e PreventKeyboardDisplayOnProgrammaticFocus. Per altre informazioni ed esempi, vedere Usare l'ambito di input per modificare la tastiera tocco.

Nota

Anche se questa proprietà può contenere una raccolta di valori InputScopeName , viene usata solo la prima e il resto viene ignorato.

Vedi anche

• IsSpellCheckEnabledProperty
• IsTextPredictionEnabledProperty
• InputScopeNameValue
• Usare l'ambito di input per modificare la tastiera virtuale