TextBox.InputScope Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define o contexto de entrada usado por esta 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>

Valor da propriedade

InputScope

O escopo de entrada, que fornece uma dica sobre o tipo de entrada de texto esperado pelo controle. O padrão é nulo.

Exemplos

Veja como definir o InputScope em XAML e no código.

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

Comentários

O escopo de entrada fornece uma dica sobre o tipo de entrada de texto esperado pelo controle. Vários elementos do sistema podem responder à dica fornecida pelo escopo de entrada e fornecer uma interface do usuário especializada para o tipo de entrada. Por exemplo, o teclado virtual pode mostrar um teclado numérico para entrada de texto quando o controle tiver seu InputScope definido como Número. Consulte a enumeração InputScopeNameValue para obter uma lista completa de valores de escopo de entrada.

O controle também pode interpretar os dados inseridos de forma diferente (normalmente para escopos de entrada relacionados ao Leste Asiático). O escopo de entrada não executa nenhuma validação e não impede que o usuário forneça nenhuma entrada por meio de um teclado de hardware ou outro dispositivo de entrada.

Outras propriedades que afetam o teclado virtual são IsSpellCheckEnabled, IsTextPredictionEnabled e PreventKeyboardDisplayOnProgrammaticFocus. Para obter mais informações e exemplos, consulte Usar o escopo de entrada para alterar o teclado virtual.

Observação

Embora essa propriedade possa conter uma coleção de valores InputScopeName , somente o primeiro é usado e o restante é ignorado.

Confira também

• IsSpellCheckEnabledProperty
• IsTextPredictionEnabledProperty
• InputScopeNameValue
• Usar o escopo de entrada para alterar o teclado virtual