ImmNotifyIME 関数 (imm.h)
入力コンテキストの状態の変更について IME に通知します。
構文
BOOL ImmNotifyIME(
HIMC unnamedParam1,
[in] DWORD dwAction,
[in] DWORD dwIndex,
[in] DWORD dwValue
);
パラメーター
unnamedParam1
[in] dwAction
通知コード。 このパラメーターには、次のいずれかの値を指定できます。
| 値 | 説明 |
|---|---|
|
アプリケーションによって、現在選択されている候補が変更されました。 dwIndex パラメーターは、選択する候補リストのインデックスを指定し、dwValue は使用されません。 |
|
アプリケーションは、候補リストを閉じるよう IME に指示します。 dwIndex パラメーターは、閉じるリストのインデックスを指定します。dwValue は使用されません。 IME は、リストを閉じると、 IMN_CLOSECANDIDATE コマンドをアプリケーションに送信します。 |
|
アプリケーションは、コンポジション文字列に対してアクションを実行するように IME に指示します。 dwIndex パラメーターには、CPS_CANCEL、CPS_COMPLETE、CPS_CONVERT、またはCPS_REVERTを指定できます。 |
|
アプリケーションは、アプリケーションが指定したメニューを処理できるように IME を指示します。 dwIndex パラメーターはメニューの ID を指定し、dwValue はそのメニュー項目のアプリケーション定義値です。 |
|
アプリケーションは、IME に候補リストを開くよう指示します。 dwIndex パラメーターは、開くリストのインデックスを指定します。dwValue は使用されません。 IME は、一覧を開くと、 IMN_OPENCANDIDATE コマンドをアプリケーションに送信します。 |
|
アプリケーションが候補の 1 つを選択しました。 dwIndex パラメーターは、選択する候補リストのインデックスを指定します。 dwValue パラメーターは、選択した候補リスト内の候補文字列のインデックスを指定します。 |
|
アプリケーションは、候補リストのページ サイズを変更します。 dwIndex パラメーターは、変更する候補リストを指定し、0 から 3 の範囲の値を持つ必要があります。 dwValue パラメーターは、新しいページ サイズを指定します。 |
|
アプリケーションは、候補リストのページ開始インデックスを変更します。 dwIndex パラメーターは、変更する候補リストを指定し、0 から 3 の範囲の値を持つ必要があります。 dwValue パラメーターは、新しいページ開始インデックスを指定します。 |
[in] dwIndex
候補リストのインデックス。 または、 dwAction がNI_COMPOSITIONSTR場合、このパラメーターには次のいずれかの値を指定できます。
| 値 | 説明 |
|---|---|
|
コンポジション文字列をクリアし、状態をコンポジション文字列なしに設定します。 |
|
合成文字列を結果文字列として設定します。 |
|
コンポジション文字列を変換します。 |
|
現在のコンポジション文字列を取り消し、コンポジション文字列を変換されていない文字列に設定します。 |
[in] dwValue
候補文字列のインデックス。 アプリケーションでは、 dwAction パラメーターの値に応じて、このパラメーターを設定することも無視することもできます。
戻り値
成功した場合は 0 以外、それ以外の場合は 0 を返します。
要件
| サポートされている最小のクライアント | Windows XP [デスクトップ アプリのみ]、東アジア言語のサポートがインストールされています。 |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | imm.h (Immdev.h、Windows.h を含む) |
| Library | Imm32.lib |
| [DLL] | Imm32.dll |