TextBox.InputScope プロパティ

定義

名前空間:

Windows.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

コントロールで予期されるテキスト入力の種類にヒントを提供する入力スコープ。 既定値は null です。

例

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