ITfThreadMgr

ITfThreadMgr は、TSF マネージャーが実装する中心的なオブジェクトを定義します。ITfThreadMgr は、アプリケーションおよびテキストサービスがテキストサービスの有効化/無効化、ドキュメントマネージャーの作成、ドキュメントコンテキストのフォーカス管理を行うために使用します。

アプリケーションは、次の例のように CLSID_TF_ThreadMgr を指定して CoCreateInstance を呼び出すことで、このインターフェイスへのポインターを取得します。

テキストサービスは、ITfTextInputProcessor::Activate メソッドでこのインターフェイスへのポインターを受け取ります。

例

HRESULT hr;
ITfThreadMgr* pThreadMgr;

hr = CoCreateInstance(  CLSID_TF_ThreadMgr, 
                        NULL, 
                        CLSCTX_INPROC_SERVER, 
                        IID_ITfThreadMgr, 
                        (void**)&pThreadMgr);

ITfThreadMgr::Activate メソッド

このメソッドは次のいずれかの値を返します。

このメソッドは 1 つのスレッドから複数回呼び出せますが、各呼び出しは同じスレッドからの対応する ITfThreadMgr::Deactivate の呼び出しと対にする必要があります。

ITfThreadMgr::Deactivate メソッド

このメソッドは次のいずれかの値を返します。

このメソッドの各呼び出しは、先行する ITfThreadMgr::Activate の呼び出しと対にする必要があります。また、対応する ITfThreadMgr::Activate を呼び出したスレッドと同じスレッドから呼び出す必要があります。

ITfThreadMgr::CreateDocumentMgr メソッド

このメソッドは次のいずれかの値を返します。

呼び出し元は、不要になったドキュメントマネージャーを解放する必要があります。

ITfThreadMgr::EnumDocumentMgrs メソッド

このメソッドは次のいずれかの値を返します。

呼び出し元は、不要になった列挙子を解放する必要があります。

ITfThreadMgr::GetFocus メソッド

このメソッドは次のいずれかの値を返します。

ITfThreadMgr::SetFocus メソッド

このメソッドは次のいずれかの値を返します。

アプリケーションは、ドキュメントウィンドウが入力フォーカスを受け取ったときにこのメソッドを呼び出す必要があります。ITfThreadMgr::AssociateFocus を使用してウィンドウとドキュメントマネージャーを関連付けている場合は、TSF マネージャーがアプリケーションに代わってこのメソッドを呼び出します。

ITfThreadMgr::AssociateFocus メソッド

このメソッドは次のいずれかの値を返します。

このメソッドは、アプリケーション開発者の利便性のために用意されています。ウィンドウのフォーカスをドキュメントマネージャーに関連付けると、そのウィンドウがフォーカスを受け取ったときに、TSF マネージャーが関連付けられたドキュメントマネージャーを指定して ITfThreadMgr::SetFocus を自動的に呼び出します。

このメソッドで関連付けられるのは、1 つのウィンドウと 1 つのドキュメントマネージャーだけです。1 つのウィンドウに複数のドキュメントマネージャーを関連付ける場合(またはその逆の場合)、実装側で ITfThreadMgr::SetFocus を呼び出して適切なドキュメントマネージャーにフォーカスを設定する必要があります。

以前のフォーカスの関連付けを復元するには、同じウィンドウハンドルと、最初の呼び出しで ppdimPrev に返された値を pdimNew に指定してこのメソッドを呼び出します。次に例を示します。

//associate the focus for m_hwnd with m_pDocMgr 
pThreadMgr->AssociateFocus(m_hwnd, m_pDocMgr, &m_pPrevDocMgr);



//Restore the original focus association. 
ITfDocumentMgr *pTempDocMgr = NULL;

pThreadMgr->AssociateFocus(m_hwnd, m_pPrevDocMgr, &pTempDocMgr);

if(pTempDocMgr)
{
    pTempDocMgr->Release();
}
    
if(m_pPrevDocMgr)
{
    m_pPrevDocMgr->Release();
}

ITfThreadMgr::IsThreadFocus メソッド

このメソッドは次のいずれかの値を返します。

ITfThreadMgr::GetFunctionProvider メソッド

このメソッドは次のいずれかの値を返します。

関数プロバイダーは、IID_ITfFunctionProvider を指定して TSF マネージャーの ITfSourceSingle::AdviseSingleSink メソッドを呼び出すことで登録します。

ITfThreadMgr::EnumFunctionProviders メソッド

このメソッドは次のいずれかの値を返します。

列挙子には、登録された関数プロバイダーのみが含まれます。ITfThreadMgr::GetFunctionProvider で説明されている定義済みの関数プロバイダーは含まれません。

関数プロバイダーは、IID_ITfFunctionProvider を指定して TSF マネージャーの ITfSourceSingle::AdviseSingleSink メソッドを呼び出すことで自身を登録します。

ITfThreadMgr::GetGlobalCompartment メソッド

このメソッドは次のいずれかの値を返します。