ITfInputProcessorProfileMgr::ActivateProfile メソッド (msctf.h)

  • [アーティクル]

ITfInputProcessorProfileMgr::ActivateProfile メソッドは、指定されたテキスト サービスのプロファイルまたはキーボード レイアウトをアクティブにします。

構文

HRESULT ActivateProfile(
  [in] DWORD    dwProfileType,
  [in] LANGID   langid,
  [in] REFCLSID clsid,
  [in] REFGUID  guidProfile,
  [in] HKL      hkl,
  [in] DWORD    dwFlags
);

パラメーター

[in] dwProfileType

[入力]このプロファイルの種類。 これは、これらの値のいずれかです。

値 意味
TF_PROFILETYPE_INPUTPROCESSOR
 これはテキスト サービスです。
TF_PROFILETYPE_KEYBOARDLAYOUT
 これはキーボード レイアウトです。

[in] langid

[入力]アクティブ化するプロファイルの言語 ID。

[in] clsid

[入力]アクティブ化するプロファイルのテキスト・サービスの CLSID。 dwProfileType がTF_PROFILETYPE_KEYBOARDLAYOUT場合、これはCLSID_NULLする必要があります。

[in] guidProfile

[入力]アクティブ化するプロファイルの guidProfile。 dwProfileType がTF_PROFILETYPE_KEYBOARDLAYOUT場合は、これをGUID_NULLする必要があります。

[in] hkl

[入力]キーボード レイアウトのハンドル。 dwProfileType がTF_PROFILETYPE_INPUTPROCESSOR場合、これは NULL である必要があります。

[in] dwFlags

次のビットの組み合わせ:

値 意味
TF_IPPMF_FORPROCESS
 プロセス内のすべてのスレッドに対してこのプロファイルをアクティブ化します。
TF_IPPMF_FORSESSION
 現在のデスクトップのすべてのスレッドに対して、このプロファイルをアクティブにします。
TF_IPPMF_ENABLEPROFILE
 レジストリを更新して、このユーザーのこのプロファイルを有効にします。
TF_IPPMF_DISABLEPROFILE
TF_IPPMF_DONTCARECURRENTINPUTLANGUAGE
 現在の入力言語が要求されたプロファイルの言語と一致しない場合、TSF は、要求された入力言語が切り替えられると、このプロファイルをアクティブ化するようにマークします。 このフラグがオフで、現在の入力言語が一致しない場合、このメソッドは失敗します。

戻り値

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

値 説明
S_OK
 メソッドは正常に実行されました。
S_FALSE
 言語プロファイルが有効になっていません。
E_FAIL
 未指定のエラーが発生しました。
E_INVALIDARG
 1 つ以上のパラメーターが無効です。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー msctf.h
[DLL] Msctf.dll

こちらもご覧ください

ITfInputProcessorProfileMgr

ITfInputProcessorProfileMgr::D eactivateProfile