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
• 使用輸入範圍來變更觸控式鍵盤