TextBox.InputScope Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает контекст для входных данных, используемых этим элементом 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>
Значение свойства
Область ввода, которая предоставляет указание на тип текстового ввода, ожидаемого элементом управления. Значение по умолчанию — NULL.
Примеры
Ниже описано, как задать 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;
Комментарии
Область ввода предоставляет указание на тип текстового ввода, ожидаемого элементом управления . Различные элементы системы могут реагировать на подсказку, предоставляемую областью ввода, и предоставлять специализированный пользовательский интерфейс для типа входных данных. Например, сенсорная клавиатура может отображать числовую панель для ввода текста, если для элемента управления InputScope задано значение Число. Полный список значений входной области см. в перечислении InputScopeNameValue .
Элемент управления также может интерпретировать введенные данные по-разному (обычно для областей ввода, связанных с Восточной Азии). Область ввода не выполняет никакой проверки и не запрещает пользователю вводить данные с помощью аппаратной клавиатуры или другого устройства ввода.
Другие свойства, влияющие на сенсорную клавиатуру: IsSpellCheckEnabled, IsTextPredictionEnabled и PreventKeyboardDisplayOnProgrammaticFocus. Дополнительные сведения и примеры см. в статье Изменение сенсорной клавиатуры с помощью области ввода.
Примечание
Хотя это свойство может содержать коллекцию значений InputScopeName , используется только первое, а остальные игнорируются.