次の方法で共有


CoreTextEditContext クラス

定義

テキスト入力コントロールがテキスト入力サーバーと通信するために使用するプライマリ オブジェクト。

public ref class CoreTextEditContext sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreTextEditContext final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CoreTextEditContext
Public NotInheritable Class CoreTextEditContext
継承
Object Platform::Object IInspectable CoreTextEditContext
属性

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

この型のオブジェクトを取得するには、 CoreTextServicesManager.CreateEditContext を呼び出します。

バージョン履歴

Windows のバージョン SDK バージョン 追加された値
1511 10586 NotifyFocusLeaveCompleted

プロパティ

InputPaneDisplayPolicy

テキスト入力コントロールにフォーカスが入ったときに入力ウィンドウを自動的に表示するかどうかを示す値を取得または設定します。 既定値は [自動] で、入力ウィンドウが自動的に表示されることを示します。 [ 手動] の値は、 InputPane.TryShow と TryHide を使用して入力ウィンドウの表示と非表示をアプリが担当することを示 します

InputScope

テキスト入力コントロールの入力スコープを示す値を取得または設定します。

IsReadOnly

編集コントロールが編集可能かどうかを示す値を取得または設定します。

Name

テキスト入力コントロールのわかりやすい名前を取得または設定します。 通常、アプリケーション フレームワークでは "name" や "id" などのプロパティを使用してコントロールを識別するため、入力プロセッサが入力コンテキストをより適切に保持し、より適切な提案を提供できるように、テキスト入力サーバーでこのプロパティを適切に設定することをお勧めします。

メソッド

NotifyFocusEnter()

テキスト入力コントロールにフォーカスが入力されたことをテキスト入力サーバーに通知します。

NotifyFocusLeave()

フォーカスがテキスト入力コントロールから離れたことをテキスト入力サーバーに通知します。

NotifyLayoutChanged()

テキスト入力コントロール内のテキストのレイアウトが変更されたことをテキスト入力サーバーに通知します。

NotifySelectionChanged(CoreTextRange)

テキスト入力コントロールが選択範囲に対して行う必要がある変更について、テキスト入力サーバーに通知します。 これは、コントロールの内部状態とサーバーの内部状態を同期させるために重要です。

NotifyTextChanged(CoreTextRange, Int32, CoreTextRange)

テキスト入力コントロールがテキストに対して行う必要がある変更について、テキスト入力サーバーに通知します。 これは、コントロールの内部状態とサーバーの内部状態を同期させるために重要です。 テキストの変更は選択範囲にも影響を与える可能性があるため、メソッドは選択範囲をパラメーターとして受け取ります。

イベント

CompositionCompleted

コンポジションが完了したときに発生します。

CompositionStarted

コンポジションが開始されたときに発生します。

FocusRemoved

テキスト入力コントロールからフォーカスが強制的に削除されたときに発生します。 それに応じて、アプリケーションでこのイベントを処理して、テキスト入力コントロールのフォーカスを削除する必要があります。

FormatUpdating

テキスト入力サーバーが特定のテキスト範囲に異なる形式を適用する必要がある場合に発生します。 これは通常、コンポジション中に発生します。

LayoutRequested

テキスト入力サーバーが、テキスト範囲とテキスト入力コントロール自体の境界ボックスを取得する必要がある場合に発生します。 アプリケーションはこのイベントを処理し、要求されたジオメトリ情報を返す必要があります。

NotifyFocusLeaveCompleted

フォーカスがテキスト入力コントロールを離れた後に発生します。

SelectionRequested

テキスト入力サーバーが、テキスト入力コントロールで現在選択されているテキストを表すテキスト範囲を取得する必要がある場合に発生します。 アプリケーションはこのイベントを処理し、要求された範囲を返す必要があります。

SelectionUpdating

テキスト入力サーバーが、テキスト入力コントロールで現在選択されているテキストの範囲を変更する必要がある場合に発生します。 このイベントは、入力プロセッサがテキストを選択するか、キャレットを移動する必要がある結果である可能性があります。 テキスト入力コントロールは、それに応じて選択範囲を設定する必要があります。

TextRequested

テキスト入力サーバーがテキスト入力コントロールからテキストの範囲を取得する必要がある場合に発生します。 アプリケーションはこのイベントを処理し、要求された範囲を返す必要があります。

TextUpdating

テキスト入力サーバーがテキスト入力コントロール内のテキストを変更する必要がある場合に発生します。 このイベントは、1 文字の挿入などのキー イベントの結果、または自動修正や予測などの入力プロセッサによって実行された処理の結果である可能性があります。

イベントを処理する場合、テキスト入力コントロールは、範囲をサーバーによって提供される新しいテキストに置き換え、キャレットを新しいテキストの末尾に移動する必要があります。

適用対象

こちらもご覧ください