RichEditBox.InputScope プロパティ

  • リファレンス

定義

名前空間:
Windows.UI.Xaml.Controls
編集

この RichEditBox で使用される入力のコンテキストを取得または設定します。

public:
 property InputScope ^ InputScope { InputScope ^ get(); void set(InputScope ^ value); };
InputScope InputScope();

void InputScope(InputScope value);
public InputScope InputScope { get; set; }
var inputScope = richEditBox.inputScope;
richEditBox.inputScope = inputScope;
Public Property InputScope As InputScope
<RichEditBox InputScope="inputScopeName" .../>
- or -
<RichEditBox>
  <RichEditBox.InputScope>
    <InputScope>
      <InputScope.Names>
        <InputScopeName NameValue="inputScopeName"/>
      </InputScope.Names>
    </InputScope>
  </RichEditBox.InputScope>
</RichEditBox>

プロパティ値

InputScope

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

例

XAML とコードで InputScope を設定する方法を次に示します。

<RichEditBox InputScope="Formula"/>

RichEditBox editBox = new RichEditBox();

InputScope scope = new InputScope();
InputScopeName scopeName = new InputScopeName();
scopeName.NameValue = InputScopeNameValue.Formula;
scope.Names.Add(scopeName);
editBox.InputScope = scope;

注釈

入力スコープは、コントロールで想定されるテキスト入力の種類に関するヒントを提供します。 システムのさまざまな要素は、入力スコープによって提供されるヒントに応答し、入力の種類に特化した UI を提供できます。 たとえば、コントロールの InputScope が Number に設定されている場合、ソフト キーボードにテキスト入力用の数字パッドが表示される場合があります。 入力スコープ値の完全な一覧については、 InputScopeNameValue 列挙を参照してください。

コントロールは、入力されるデータを異なる方法で解釈する場合もあります (通常は東アジア関連の入力スコープの場合)。 入力スコープは検証を実行せず、ユーザーがハードウェア キーボードやその他の入力デバイスを介して入力を提供することを妨げません。

重要

このプロパティは InputScopeName 値のコレクションを保持できますが、ほとんどの場合、最初の 値のみが使用されます。 唯一の例外は、 が値として指定されている場合 Private です。 Private は、コレクション内の場所に関係なく、無視されることはありません。 がコレクションの最初の項目の場合 Private は、コレクション内の次の項目 (存在する場合) も使用されます。

適用対象

こちらもご覧ください