ITfTextInputProcessor::Activate メソッド (msctf.h)

ユーザーセッションの開始時にテキストサービスをアクティブにします。

構文

HRESULT Activate(
  [in] ITfThreadMgr *ptim,
  [in] TfClientId   tid
);

[in] ptim

テキストサービスを所有するスレッドマネージャーの ITfThreadMgr インターフェイスへのポインター。

[in] tid

テキストサービスのクライアント識別子を指定します。

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

TSF は、CoCreateInstance を呼び出してテキストサービスのインスタンスを作成した後、このメソッドを呼び出します。これにより、テキストサービスを開始するために必要な操作が可能になります。

このメソッドは通常、セッションのスレッドマネージャーへの参照を追加し、フォーカスの変更、キーストローク、ウィンドウイベントなど、テキストサービスを含むイベントのシンクにアドバイスします。また、テキストサービスの言語バーもカスタマイズします。

テキストサービスをシャットダウンする対応する ITfTextInputProcessor::D eactivate メソッドは、 ptim パラメーターへのすべての参照を解放する必要があります。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	msctf.h
[DLL]	Sptip.dll
再頒布可能パッケージ	Windows 2000 Professional の TSF 1.0