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