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
• 入力値の種類を使ったタッチ キーボードの変更