TextBox.InputScope 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
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>
属性值
输入范围,它提供控件所需的文本输入类型的提示。
示例
下面介绍如何在 XAML 和代码中设置 InputScope 。
<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;
注解
输入范围提供控件预期的文本输入类型的提示。 系统的各种元素可以响应输入范围提供的提示,并为输入类型提供专用 UI。 例如,当控件的 InputScope 设置为 Number
时,触摸键盘可能会显示文本输入的数字键盘。 有关输入范围值的完整列表,请参阅 InputScopeNameValue 枚举。
对于东亚相关输入范围) ,控件还可能以不同的方式解释 (输入的数据。 输入范围不执行任何验证,并且不会阻止用户通过硬件键盘或其他输入设备提供任何输入。
影响触摸键盘的其他属性是 IsSpellCheckEnabled、IsTextPredictionEnabled 和 PreventKeyboardDisplayOnProgrammaticFocus。 有关详细信息和示例,请参阅 使用输入范围更改触摸键盘。
注意
虽然此属性可以保存 InputScopeName 值的集合,但只使用第一个值,而忽略其余的值。