TextBox.InputScope Свойство

Определение

Пространство имен:

Microsoft.UI.Xaml.Controls

Возвращает или задает контекст для входных данных, используемых в этом текстовом поле.

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>

Значение свойства

InputScope

Область ввода, которая предоставляет указание типа ввода текста, ожидаемого элементом управления.

Примеры

Вот как задать InputScope в XAML и коде.

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

Комментарии

Область ввода предоставляет указание типа ввода текста, ожидаемого элементом управления. Различные элементы системы могут реагировать на указание, предоставленное областью ввода, и предоставить специализированный пользовательский интерфейс для типа входных данных. Например, сенсорный клавиатура может отображать числовую панель для ввода текста, если элемент управления имеет значение NumberInputScope. Полный список входных значений области см. в перечислении InputScopeNameValue .

Элемент управления также может интерпретировать данные, введенные по-разному (обычно для областей ввода, связанных с Восточной Азии). Область ввода не выполняет никаких проверок и не запрещает пользователю предоставлять входные данные с помощью аппаратной клавиатуры или другого устройства ввода.

Другими свойствами, влияющими на сенсорную клавиатуру, являются IsSpellCheckEnabled, IsTextPredictionEnabled и PreventKeyboardDisplayOnProgrammaticFocus. Дополнительные сведения и примеры см. в разделе "Использование области ввода" для изменения сенсорной клавиатуры.

Note

Хотя это свойство может содержать коллекцию значений InputScopeName , используется только первая, а остальные игнорируются.

См. также раздел

• IsSpellCheckEnabledProperty
• IsTextPredictionEnabledProperty
• InputScopeNameValue
• Использование области ввода для изменения сенсорной клавиатуры