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>

属性值

输入范围,它提供控件所需的文本输入类型的提示。

示例

下面介绍如何在 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 枚举。

对于东亚相关输入范围) ,控件还可能以不同的方式解释 (输入的数据。 输入范围不执行任何验证,并且不会阻止用户通过硬件键盘或其他输入设备提供任何输入。

影响触摸键盘的其他属性是 IsSpellCheckEnabledIsTextPredictionEnabledPreventKeyboardDisplayOnProgrammaticFocus。 有关详细信息和示例,请参阅 使用输入范围更改触摸键盘

注意

虽然此属性可以保存 InputScopeName 值的集合,但只使用第一个值,而忽略其余的值。

适用于

另请参阅