ITfThreadMgrEx::ActivateEx メソッド (msctf.h)

  • [アーティクル]

ITfThreadMgrEx::ActivateEx メソッドは、呼び出し元スレッドの TSF を初期化およびアクティブ化するためにアプリケーションによって使用されます。 ITfThreadMgr::Activate とは異なり、ITfThreadMgrEx::ActivateEx はフラグを取って TSF のアクティブ化方法を指定できます。

構文

HRESULT ActivateEx(
  [out] TfClientId *ptid,
  [in]  DWORD      dwFlags
);

パラメーター

[out] ptid

[out]クライアント識別子を受け取る TfClientId 値へのポインター。

[in] dwFlags

値 意味
TF_TMAE_NOACTIVATETIP
 ITfThreadMgrEx::ActivateEx が呼び出されている間、テキスト サービスはアクティブになりません。 これらは、呼び出し元のスレッドが非同期的にフォーカスを持っている場合にアクティブになります。
TF_TMAE_SECUREMODE
 TSF はセキュア モードでアクティブ化されます。 セキュリティで保護されたモードをサポートするテキスト サービスのみがアクティブになります。
TF_TMAE_UIELEMENTENABLEDONLY
 TSF は、GUID_TFCAT_TIPCAP_UIELEMENTENABLEDに分類されているテキスト サービスのみをアクティブにします。
TF_TMAE_COMLESS
 TSF は COM を使用しません。 TSF は、GUID_TFCAT_TIPCAP_COMLESSに分類されているテキスト サービスのみをアクティブにします。
TF_TMAE_NOACTIVATEKEYBOARDLAYOUT
 ITfThreadMgrEx::ActivateEx() が呼び出されている間、TSF は現在のキーボード レイアウトを同期しません。 呼び出し元のスレッドがフォーカスを取得すると、キーボード レイアウトが調整されます。 このフラグは、TF_TMAE_NOACTIVATETIPで使用する必要があります。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 説明
S_OK
 メソッドは正常に実行されました。
E_FAIL
 未指定のエラーが発生しました。
E_INVALIDARG
 1 つ以上のパラメーターが無効です。

要件

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

こちらもご覧ください

ITfThreadMgr::Activate

ITfThreadMgrEx