msctf.h ヘッダー

このヘッダーは、Text Services Framework によって使用されます。 詳細については、次を参照してください。

• Text Services Framework (TSF)

msctf.h には、次のプログラミング インターフェイスが含まれています。

インターフェイス

IEnumITfCompositionView IEnumITfCompositionView インターフェイスは、コンポジション ビュー オブジェクトの列挙を提供するために TSF マネージャーによって実装されます。
IEnumTfContexts IEnumTfContexts インターフェイスは、コンテキスト オブジェクトの列挙を提供するために TSF マネージャーによって実装されます。
IEnumTfContextViews 実装されていません。 (IEnumTfContextViews)
IEnumTfDisplayAttributeInfo IEnumTfDisplayAttributeInfo インターフェイスは、表示属性情報オブジェクトの列挙を提供するために TSF マネージャーによって実装されます。
IEnumTfDocumentMgrs IEnumTfDocumentMgrs インターフェイスは、ドキュメント マネージャー オブジェクトの列挙を提供するために TSF マネージャーによって実装されます。
IEnumTfFunctionProviders IEnumTfFunctionProviders インターフェイスは、関数プロバイダー オブジェクトの列挙を提供するために TSF マネージャーによって実装されます。
IEnumTfInputProcessorProfiles IEnumTfInputProcessorProfiles インターフェイスは TSF マネージャーによって実装され、アプリケーションまたはテキスト サービスによって使用されます。 このインターフェイスは、ITfInputProcessorProfileMgr::EnumProfiles によって取得され、登録済みのプロファイルを列挙します。
IEnumTfLanguageProfiles IEnumTfLanguageProfiles インターフェイスは、言語プロファイルの列挙を提供するために TSF マネージャーによって実装されます。
IEnumTfProperties IEnumTfProperties インターフェイスは、プロパティ オブジェクトの列挙を提供するために TSF マネージャーによって実装されます。
IEnumTfPropertyValue IEnumTfPropertyValue インターフェイスは、プロパティ値の列挙を提供するために TSF マネージャーによって実装されます。
IEnumTfRanges IEnumTfRanges インターフェイスは、範囲オブジェクトの列挙を提供するために TSF マネージャーによって実装されます。
IEnumTfUIElements IEnumTfUIElements インターフェイスは TSF マネージャーによって実装され、アプリケーションまたはテキスト サービスによって使用されます。 このインターフェイスは ITfUIElementMgr::EnumUIElements によって取得され、登録済みの UI 要素を列挙します。
ITextStoreACPServices ITextStoreACPServices インターフェイスは、ACP ベースのアプリケーションにさまざまなサービスを提供するために TSF マネージャーによって実装されます。
ITfActiveLanguageProfileNotifySink ITfActiveLanguageProfileNotifySink インターフェイスは、アクティブな言語またはテキスト サービスが変更されたときに通知を受け取るためにアプリケーションによって実装されます。
ITfCandidateListUIElement ITfCandidateListUIElement インターフェイスは、候補リスト UI を持つテキスト サービスによって実装されます。
ITfCandidateListUIElementBehavior このインターフェイスは、候補リスト UI を持つテキスト サービスによって実装され、その UI はアプリケーションによって制御できます。 ITfUIElement からのアプリケーション QI このインターフェイスは、候補リストの動作を制御します。
ITfCategoryMgr ITfCategoryMgr インターフェイスは、テキスト サービスのオブジェクトのカテゴリを管理します。 TSF マネージャーはこのインターフェイスを実装します。
ITfCleanupContextDurationSink ITfCleanupContextDurationSink インターフェイスは、コンテキストクリーンアップ操作が実行されたときに通知を受け取るためにテキスト サービスによって実装されます。
ITfCleanupContextSink ITfCleanupContextSink インターフェイスは、コンテキスト クリーンアップ操作が発生したときに通知を受信するためにテキスト サービスによって実装されます。 この通知シンクは、IID_ITfCleanupContextSinkを使用して ITfSourceSingle::AdviseSingleSink を呼び出すことによってインストールされます。
ITfClientId ITfClientId インターフェイスは TSF マネージャーによって実装されます。 このインターフェイスは、TSF オブジェクトのクライアント識別子を取得するために使用されます。 このインターフェイスのインスタンスは、IID_ITfClientIdを使用してスレッド マネージャーに対してクエリを実行することによって取得されます。
ITfCompartment ITfCompartment インターフェイスは TSF マネージャーによって実装され、クライアント (アプリケーションとテキスト サービス) によって TSF コンパートメント内のデータを取得および設定するために使用されます。
ITfCompartmentEventSink ITfCompartmentEventSink インターフェイスは、クライアント (アプリケーションまたはテキスト サービス) によって実装され、コンパートメント データが変更されたときにクライアントに通知するために TSF マネージャーによって使用されます。
ITfCompartmentMgr ITfCompartmentMgr インターフェイスは TSF マネージャーによって実装され、TSF コンパートメントを取得および操作するためにクライアント (アプリケーションとテキスト サービス) によって使用されます。
ITfComposition ITfComposition インターフェイスは TSF マネージャーによって実装され、合成に関するデータを取得して終了するためにテキスト サービスによって使用されます。 このインターフェイスのインスタンスは、ITfContextComposition::StartComposition メソッドによって提供されます。
ITfCompositionSink ITfCompositionSink インターフェイスは、コンポジションが終了したときに通知を受け取るためにテキスト サービスによって実装されます。
ITfCompositionView ITfCompositionView インターフェイスは TSF マネージャーによって実装され、コンポジション ビューに関するデータを取得するためにアプリケーションによって使用されます。 このインターフェイスのインスタンスは、ITfContextOwnerCompositionSink メソッドのいずれかによって提供されます。
ITfConfigureSystemKeystrokeFeed ITfConfigureSystemKeystrokeFeed インターフェイスは、キーストロークの処理を有効または無効にするために TSF マネージャーによって実装されます。
ITfContext ITfContext インターフェイスは TSF マネージャーによって実装され、編集コンテキストにアクセスするためにアプリケーションとテキスト サービスによって使用されます。
ITfContextComposition ITfContextComposition インターフェイスは TSF マネージャーによって実装され、テキスト サービスによってコンポジションを作成および操作するために使用されます。 このインターフェイスのインスタンスは、IID_ITfContextCompositionを使用して ITfContext::QueryInterface によって提供されます。
ITfContextKeyEventSink ITfContextKeyEventSink インターフェイスは、テキスト サービスによって実装され、入力コンテキストで発生するキーボード イベント通知を受信します。
ITfContextOwner ITfContextOwner インターフェイスは、テキスト ストアを使用せずにテキスト入力を受け取るために、アプリケーションまたはテキスト サービスによって実装されます。 このインターフェイスのインスタンスは、アプリケーションが ITfSource::AdviseSink メソッドを呼び出すときに取得されます。
ITfContextOwnerCompositionServices ITfContextOwnerCompositionServices インターフェイスは TSF マネージャーによって実装され、コンテキスト所有者がテキスト サービスによって作成されたコンポジションを操作するために使用されます。
ITfContextOwnerCompositionSink ITfContextOwnerCompositionSink インターフェイスは、コンポジション関連の通知を受け取るためにアプリケーションによって実装されます。
ITfContextOwnerServices ITfContextOwnerServices インターフェイスはマネージャーによって実装され、コンテキスト所有者として機能するテキスト サービスまたはアプリケーションによって使用されます。
ITfContextView ITfContextView インターフェイスは TSF マネージャーによって実装され、クライアント (アプリケーションまたはテキスト サービス) によって使用され、コンテキスト ビューに関する情報を取得します。
ITfCreatePropertyStore ITfCreatePropertyStore インターフェイスは、プロパティ ストア データの永続化をサポートするためにテキスト サービスによって実装されます。
ITfDisplayAttributeInfo ITfDisplayAttributeInfo インターフェイスは、表示属性データを提供するためにテキスト サービスによって実装されます。 このインターフェイスは、テキストの表示方法を決定する必要があるコンポーネント (ほとんどの場合、アプリケーション) によって使用されます。
ITfDisplayAttributeMgr ITfDisplayAttributeMgr インターフェイスは TSF マネージャーによって実装され、表示属性を取得および列挙するためにアプリケーションによって使用されます。 個々の表示属性は、ITfDisplayAttributeInfo インターフェイスを介してアクセスされます。
ITfDisplayAttributeNotifySink ITfDisplayAttributeNotifySink インターフェイスは、表示属性情報が更新されたときに通知を受け取るためにアプリケーションによって実装されます。
ITfDisplayAttributeProvider ITfDisplayAttributeProvider インターフェイスはテキスト サービスによって実装され、TSF マネージャーが個々の表示属性情報オブジェクトを列挙および取得するために使用されます。
ITfDocumentMgr ITfDocumentMgr インターフェイスは TSF マネージャーによって実装され、テキスト コンテキストを作成および管理するためにアプリケーションまたはテキスト サービスによって使用されます。 このインターフェイスのインスタンスを取得するには、ITfThreadMgr::CreateDocumentMgr を呼び出します。
ITfEditRecord ITfEditRecord インターフェイスは TSF マネージャーによって実装され、編集セッション中に何が変更されたかを判断するためにテキスト編集シンクによって使用されます。
ITfEditSession ITfEditSession インターフェイスは、テキスト サービスによって実装され、TSF マネージャーがコンテキストのテキストとプロパティの読み取りや変更に使用します。
ITfEditTransactionSink ITfEditTransactionSink インターフェイスはテキスト サービスによって実装され、編集トランザクションをサポートするために TSF マネージャーによって使用されます。
ITfFunction ITfFunction インターフェイスは、個々の関数インターフェイスの基本インターフェイスです。
ITfFunctionProvider ITfFunctionProvider インターフェイスは、さまざまな関数オブジェクトを提供するために、アプリケーションまたはテキスト サービスによって実装されます。
ITfInputProcessorProfileActivationSink ITfInputProcessorProfileActivationSink インターフェイスは、プロファイルが変更されたときに通知を受け取るためにアプリケーションによって実装されます。
ITfInputProcessorProfileMgr ITfInputProcessorProfileMgr インターフェイスは TSF マネージャーによって実装され、1 つ以上のテキスト サービスの言語プロファイルを操作するためにアプリケーションまたはテキスト サービスによって使用されます。
ITfInputProcessorProfiles ITfInputProcessorProfiles インターフェイスは TSF マネージャーによって実装され、1 つ以上のテキスト サービスの言語プロファイルを操作するためにアプリケーションまたはテキスト サービスによって使用されます。
ITfInputProcessorProfilesEx このインターフェイスは TSF マネージャーによって実装され、言語プロファイルの表示説明を設定するためにテキスト サービスまたはアプリケーションによって使用されます。
ITfInputProcessorProfileSubstituteLayout このインターフェイスは TSF マネージャーによって実装され、テキスト サービス プロファイルの代替入力ロケール識別子 (キーボード レイアウト) を操作するためにアプリケーションまたはテキスト サービスによって使用されます。
ITfInsertAtSelection ITfInsertAtSelection インターフェイスはマネージャーによって実装され、テキスト サービスによってテキストまたは埋め込みオブジェクトをコンテキストに挿入するために使用されます。 テキスト サービスは、ITfContext::QueryInterface を呼び出してこのインターフェイスを取得します。
ITfKeyEventSink ITfKeyEventSink インターフェイスは、キーボードとフォーカス イベント通知を受け取るためにテキスト サービスによって実装されます。 このイベント シンクをインストールするには、ITfKeystrokeMgr::AdviseKeyEventSink を呼び出します。
ITfKeystrokeMgr ITfKeystrokeMgr インターフェイスは TSF マネージャーによって実装され、キーボード マネージャーと対話するためにアプリケーションとテキスト サービスによって使用されます。
ITfKeyTraceEventSink ITfKeyTraceEventSink インターフェイスは、アプリケーションまたはテキスト サービスによって実装され、ターゲットによってイベントが処理される前に、キー ストローク イベント通知を受信します。
ITfLanguageProfileNotifySink ITfLanguageProfileNotifySink インターフェイスは、言語プロファイルが変更されたときに通知を受け取るためにアプリケーションによって実装されます。
ITfMessagePump ITfMessagePump インターフェイスは TSF マネージャーによって実装され、アプリケーションによってアプリケーション メッセージ キューからメッセージを取得するために使用されます。
ITfMouseSink ITfMouseSink インターフェイスは、マウス イベント通知を受信するためにテキスト サービスによって実装されます。 マウス イベント シンクは、ITfMouseTracker インターフェイスの 1 つの ITfMouseTracker::AdviseMouseSink メソッドと共にインストールされます。
ITfMouseTracker ITfMouseTracker インターフェイスは TSF マネージャーによって実装され、マウス イベント通知シンクを管理するためにテキスト サービスによって使用されます。 このインターフェイスのインスタンスは、ITfContext オブジェクトに対してIID_ITfMouseTrackerのクエリを実行することによって取得されます。
ITfMouseTrackerACP ITfMouseTrackerACP インターフェイスは、マウス イベント シンクをサポートするためにアプリケーションによって実装されます。
ITfPersistentPropertyLoaderACP ITfPersistentPropertyLoaderACP インターフェイスは、アプリケーションによって実装され、TSF マネージャーがプロパティを非同期的に読み込むのに使用されます。
ITfPreservedKeyNotifySink ITfPreservedKeyNotifySink インターフェイスは、キーが保持されている場合、予約されていない場合、または保持されているキーの説明が変更されたときに通知を受け取るために、アプリケーションまたは TSF テキスト サービスによって実装されます。
ITfProperty ITfProperty インターフェイスは TSF マネージャーによって実装され、クライアント (アプリケーションまたはテキスト サービス) によってプロパティ値を変更するために使用されます。
ITfPropertyStore ITfPropertyStore インターフェイスはテキスト サービスによって実装され、TSF マネージャーによって非静的プロパティ値を提供するために使用されます。 このインターフェイスのインスタンスは、ITfProperty::SetValueStore に渡されます。
ITfQueryEmbedded ITfQueryEmbedded インターフェイスは TSF マネージャーによって実装され、コンテキストが埋め込みオブジェクトを受け入れられるかどうかを判断するためにテキスト サービスによって使用されます。
ITfRange ITfRange インターフェイスは、特定のコンテキスト内でテキストを参照および操作するために、テキスト サービスとアプリケーションによって使用されます。 インターフェイス ID がIID_ITfRange。
ITfRangeACP ITfRangeACP インターフェイスは TSF マネージャーによって実装され、範囲オブジェクトにアクセスして操作するためにアプリケーション文字位置 (ACP) ベースのアプリケーションによって使用されます。
ITfRangeBackup ITfRangeBackup インターフェイスは TSF マネージャーによって実装され、テキスト サービスによって使用され、範囲オブジェクトに含まれるデータのバックアップ コピーを作成します。
ITfReadingInformationUIElement ITfCandidateListUIElement インターフェイスは、近くのキャレットで情報 UI を読み取るための UI を持つテキスト サービスによって実装されます。
ITfReadOnlyProperty ITfReadOnlyProperty インターフェイスは TSF マネージャーによって実装され、プロパティ データを取得するためにアプリケーションまたはテキスト サービスによって使用されます。
ITfReverseConversion 指定した文字列の逆変換を実行します。
ITfReverseConversionList 指定した文字列を作成するために必要なキーストローク シーケンスの一覧を表します。
ITfReverseConversionMgr 逆変換を実行するために使用される ITfReverseConversion オブジェクトへのアクセスを提供します。
ITfSource ITfSource インターフェイスは TSF マネージャーによって実装されます。 これは、アプリケーションとテキスト サービスによって、アドバイス シンクをインストールおよびアンインストールするために使用されます。
ITfSourceSingle ITfSourceSingle インターフェイスは、TSF マネージャーによって実装されます。
ITfStatusSink ITfStatusSink インターフェイスは、グローバル ドキュメントの状態の変更をサポートします。 このアドバイズ シンクは、IID_ITfStatusSinkで ITfSource::AdviseSink を呼び出すことによってインストールされます。 テキスト サービスでは、必要に応じてこのインターフェイスを実装できます。
ITfTextEditSink ITfTextEditSink インターフェイスは、読み取り/書き込みアクセスを含む編集セッションの完了をサポートします。
ITfTextInputProcessor ITfTextInputProcessor インターフェイスはテキスト サービスによって実装され、テキスト サービスをアクティブ化および非アクティブ化するために TSF マネージャーによって使用されます。
ITfTextInputProcessorEx ITfTextInputProcessorEx インターフェイスはテキスト サービスによって実装され、テキスト サービスをアクティブ化および非アクティブ化するために TSF マネージャーによって使用されます。
ITfTextLayoutSink ITfTextLayoutSink インターフェイスは、アプリケーションによるコンテキスト レイアウトの変更をサポートします。 IID_ITfTextLayoutSinkで ITfSource::AdviseSink を呼び出して、このアドバイズ シンクをインストールします。 テキスト サービスでは、必要に応じてこのインターフェイスを実装できます。
ITfThreadFocusSink ITfThreadFocusSink インターフェイスは、スレッドが UI フォーカスを受け取ったり失ったりしたときに通知を受け取るアプリケーションまたは TSF テキスト サービスによって実装されます。
ITfThreadMgr ITfThreadMgr は、TSF マネージャーによって実装されるプライマリ オブジェクトを定義します。 ITfThreadMgr は、テキスト サービスのアクティブ化と非アクティブ化、ドキュメント マネージャーの作成、ドキュメント コンテキストのフォーカスの維持のために、アプリケーションとテキスト サービスによって使用されます。
ITfThreadMgr2 ITfThreadMgr2 は、TSF マネージャーによって実装されるプライマリ オブジェクトを定義します。 ITfThreadMgr2 は、テキスト サービスのアクティブ化と非アクティブ化、ドキュメント マネージャーの作成、ドキュメント コンテキストフォーカスの維持のために、アプリケーションとテキスト サービスによって使用されます。
ITfThreadMgrEventSink ITfThreadMgrEventSink インターフェイスは、特定のスレッド マネージャー イベントの通知を受信するために、アプリケーションまたは TSF テキスト サービスによって実装されます。 TSF マネージャー ITfSource::AdviseSink をIID_ITfThreadMgrEventSinkと共に呼び出して、このアドバイズ シンクをインストールします。
ITfThreadMgrEx ITfThreadMgrEx インターフェイスは、いくつかのフラグを使用してテキスト サービスをアクティブ化するためにアプリケーションによって使用されます。 ITfThreadMgrEx は、ITfThreadMgr から QI によって取得できます。
ITfToolTipUIElement ITfToolTipUIElement インターフェイスは、UI にヒントを表示するテキスト サービスによって実装されます。
ITfTransitoryExtensionSink ITfTransitoryExtensionSink インターフェイスは、推移的な拡張機能 dim を使用するアプリケーションによって実装されます。アプリケーションは、このシンク インターフェイスを使用して、一時的な拡張機能で発生した変更を追跡できます。
ITfTransitoryExtensionUIElement ITfTransitoryExtensionUIElement インターフェイスは、推移的な拡張機能の UI を提供する TSF マネージャーによって実装されます。
ITfUIElement ITfUIElement インターフェイスは UIElement オブジェクトの基本インターフェイスであり、テキスト サービスによって実装されます。
ITfUIElementMgr ITfUIElementMgr インターフェイスは TSF マネージャーによって実装され、アプリケーションまたはテキスト サービスによって使用されます。 アプリケーションとテキスト サービスは、IID_ITfUIElementMgrを使用して ITfThreadMgr::QueryInterface によってこのインターフェイスを取得できます。
ITfUIElementSink ITfUIElementSink インターフェイスは、UI 要素が変更されたときに通知を受け取るためにアプリケーションによって実装されます。

関数

TF_CreateCategoryMgr TF_CreateCategoryMgr関数は、COM を初期化せずにカテゴリ マネージャー オブジェクトを作成します。 呼び出し元のスレッドは、MSCTF.DLL が所有するオブジェクトの参照カウントを維持する必要があるため、使用は慎重に行う必要があります。
TF_CreateDisplayAttributeMgr TF_CreateDisplayAttributeMgr関数は、COM を初期化することなく、表示属性マネージャー オブジェクトを作成するために使用されます。
TF_CreateInputProcessorProfiles TF_CreateInputProcessorProfiles関数は、COM を初期化せずに入力プロセッサ プロファイル オブジェクトを作成するために使用されます。
TF_CreateLangBarItemMgr TF_CreateLangBarItemMgr関数は、COM を初期化しなくても言語バー項目マネージャー オブジェクトを作成するために使用されます。
TF_CreateLangBarMgr TF_CreateLangBarMgr関数は、COM を初期化しなくても言語バー マネージャー オブジェクトを作成します。 呼び出し元プロセスは、Msctf.dll が所有するオブジェクトに対して適切な参照カウントを維持する必要があるため、このメソッドの使用はお勧めしません。
TF_CreateThreadMgr TF_CreateThreadMgr関数は、COM を初期化せずにスレッド マネージャー オブジェクトを作成します。 呼び出し元プロセスは、Msctf.dll が所有するオブジェクトに対して適切な参照カウントを維持する必要があるため、このメソッドの使用はお勧めしません。
TF_GetThreadMgr TF_GetThreadMgr関数は、呼び出し元のスレッド内で以前に作成されたスレッド マネージャー オブジェクトのコピーを取得します。

構造

TF_DA_COLOR TF_DA_COLOR構造体には、テキストの範囲の表示属性で使用される色データが含まれています。
TF_DISPLAYATTRIBUTE TF_DISPLAYATTRIBUTE構造体には、テキストをレンダリングするための表示属性データが含まれています。
TF_HALTCOND TF_HALTCOND構造体は、範囲シフトの条件を格納するために使用されます。
TF_INPUTPROCESSORPROFILE この構造体には、入力プロセッサ プロファイルのデータが含まれています。
TF_LANGUAGEPROFILE TF_LANGUAGEPROFILE構造体には、言語プロファイルに関する情報が含まれています。
TF_PERSISTENT_PROPERTY_HEADER_ACP TF_PERSISTENT_PROPERTY_HEADER_ACP構造体は、プロパティ ヘッダー データを提供するために使用されます。
TF_PRESERVEDKEY TF_PRESERVEDKEY構造体は、保持されているキーを表します。
TF_PROPERTYVAL TF_PROPERTYVAL構造体には、プロパティ値データが含まれています。 この構造体は、IEnumTfPropertyValue::Next メソッドと共に使用されます。
TF_SELECTION TF_SELECTION構造体には、テキスト選択データが含まれています。
TF_SELECTIONSTYLE TF_SELECTIONSTYLE構造体は、選択範囲のスタイルを表します。

列挙

TF_DA_ATTR_INFO TF_DA_ATTR_INFO列挙体の要素は、TF_DISPLAYATTRIBUTE構造体のテキスト変換データを指定するために使用されます。
TF_DA_COLORTYPE TF_DA_COLORTYPE列挙体の要素は、TF_DA_COLOR構造体に含まれる色の形式を指定します。
TF_DA_LINESTYLE TF_DA_LINESTYLE列挙体の要素は、TF_DA_COLOR構造体の表示属性の下線スタイルを指定します。
TfActiveSelEnd TfActiveSelEnd 列挙体の要素は、選択したテキスト範囲のどの末尾がアクティブであるかを指定します。
TfAnchor TfAnchor 列挙体の要素は、ITfRange オブジェクトの開始アンカーまたは終了アンカーを指定します。
TfGravity TfGravity 列挙体の要素は、ITfRange オブジェクトのアンカーに関連付けられている重力の種類を指定します。
TfLayoutCode TfLayoutCode 列挙体の要素は、ITfTextLayoutSink::OnLayoutChange 通知のレイアウト変更の種類を指定します。
TfShiftDir TfShiftDir 列挙体の要素は、範囲アンカーを移動する方向を指定します。