RichEditBox.InputScope Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define o contexto de entrada usado por esse RichEditBox.

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

InputScope InputScope();

void InputScope(InputScope value);

public InputScope InputScope { get; set; }

var inputScope = richEditBox.inputScope;
richEditBox.inputScope = inputScope;

Public Property InputScope As InputScope

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

Valor da propriedade

InputScope

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

Exemplos

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

<RichEditBox InputScope="Formula"/>

RichEditBox editBox = new RichEditBox();

InputScope scope = new InputScope();
InputScopeName scopeName = new InputScopeName();
scopeName.NameValue = InputScopeNameValue.Formula;
scope.Names.Add(scopeName);
editBox.InputScope = scope;

Comentários

O escopo de entrada fornece uma dica para 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 entrada por meio de um teclado de hardware ou outro dispositivo de entrada.

Importante

Embora essa propriedade possa conter uma coleção de valores InputScopeName , na maioria dos casos apenas o primeiro é usado. A única exceção a isso é quando Private é especificado como um valor. Private nunca é ignorado, independentemente de sua localização na coleção. Se Private for o primeiro item da coleção, o próximo item da coleção (se presente) também será usado.

Confira também

• InputScopeNameValue