ImmAssociateContextEx 関数 (immdev.h)

  • [アーティクル]

入力メソッド コンテキストと、指定したウィンドウまたはその子の間の関連付けを変更します。

構文

BOOL ImmAssociateContextEx(
  [in] HWND  unnamedParam1,
  [in] HIMC  unnamedParam2,
  [in] DWORD unnamedParam3
);

パラメーター

[in] unnamedParam1

入力コンテキストに関連付けるウィンドウへのハンドル。

[in] unnamedParam2

入力メソッド コンテキストを処理します。

[in] unnamedParam3

ウィンドウと入力メソッド コンテキスト間の関連付けの種類を指定するフラグ。 このパラメーターには、次のいずれかの値を指定できます。

値 説明
IACE_CHILDREN
 入力メソッド コンテキストを、指定したウィンドウの子ウィンドウのみに関連付けます。
IACE_DEFAULT
 ウィンドウの既定の入力メソッド コンテキストを復元します。
IACE_IGNORENOCONTEXT
 入力メソッド コンテキストを、入力メソッド コンテキストに関連付けられていないウィンドウに関連付けないでください。

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。

解説

アプリケーションがこの関数を IACE_CHILDREN で呼び出す場合、オペレーティング システムは、指定された入力メソッド コンテキストを hWnd で示されるウィンドウの子ウィンドウに関連付けます。 入力メソッドコンテキストは、 hWnd を作成するスレッドの子ウィンドウにのみ関連付けられます。 この関数が呼び出された後に作成された子ウィンドウは影響を受けません。 代わりに、既定の入力メソッド コンテキストが関連付けられます。

アプリケーションが IACE_DEFAULT を使用してこの関数を呼び出す場合、オペレーティング システムはウィンドウの既定の入力メソッド コンテキストを復元します。 この場合、 hIMC パラメーターは無視されます。

要件

   
サポートされている最小のクライアント Windows XP [デスクトップ アプリのみ]、東アジア言語のサポートがインストールされています。
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー immdev.h (Immdev.h、Windows.h を含む)
Library Imm32.lib
[DLL] Imm32.dll

関連項目

入力メソッド マネージャー

入力メソッド マネージャー関数