TextBox.InputScope Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Obtiene o establece el contexto de entrada utilizado por este 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 de propiedad

InputScope

Ámbito de entrada, que proporciona una sugerencia en el tipo de entrada de texto esperado por el control. El valor predeterminado es NULL.

Ejemplos

Aquí se muestra cómo establecer InputScope en XAML y en el 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;

Comentarios

El ámbito de entrada proporciona una sugerencia en el tipo de entrada de texto esperado por el control. Varios elementos del sistema pueden responder a la sugerencia proporcionada por el ámbito de entrada y proporcionar una interfaz de usuario especializada para el tipo de entrada. Por ejemplo, el teclado táctil podría mostrar un panel numérico para la entrada de texto cuando el control tiene su InputScope establecido en Number. Consulte la enumeración InputScopeNameValue para obtener una lista completa de los valores de ámbito de entrada.

El control también podría interpretar los datos que se introducen de forma diferente (normalmente para ámbitos de entrada relacionados con el Este asiático). El ámbito de entrada no realiza ninguna validación y no impide que el usuario proporcione ninguna entrada a través de un teclado de hardware u otro dispositivo de entrada.

Otras propiedades que afectan el teclado táctil son IsSpellCheckEnabled, IsTextPredictionEnabled y PreventKeyboardDisplayOnProgrammaticFocus. Para obtener más información y ejemplos, consulta Usar el ámbito de entrada para cambiar el teclado táctil.

Nota

Aunque esta propiedad puede contener una colección de valores InputScopeName , solo se usa la primera y el resto se omite.

Consulte también

• IsSpellCheckEnabledProperty
• IsTextPredictionEnabledProperty
• InputScopeNameValue
• Usar el ámbito de entrada para cambiar el teclado táctil