TextBox.InputScope 属性

定义

命名空间:

Microsoft.UI.Xaml.Controls

获取或设置此 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 和代码中设置 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 值的集合，但只使用第一个值，而忽略其余的值。

另请参阅

• IsSpellCheckEnabledProperty
• IsTextPredictionEnabledProperty
• InputScopeNameValue
• 使用输入范围更改触摸键盘