CoreTextEditContext クラス

リファレンス

定義

名前空間:: Windows.UI.Text.Core

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

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

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

属性: ContractVersionAttribute MarshalingBehaviorAttribute

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 文字の挿入などのキーイベントの結果、または自動修正や予測などの入力プロセッサによって実行された処理の結果である可能性があります。イベントを処理する場合、テキスト入力コントロールは、範囲をサーバーによって提供される新しいテキストに置き換え、キャレットを新しいテキストの末尾に移動する必要があります。

適用対象

こちらもご覧ください

カスタム編集コントロールのサンプル

次の方法で共有