ImmNotifyIME 関数 (immdev.h)

  • [アーティクル]

入力コンテキストの状態の変更について IME に通知します。

構文

BOOL ImmNotifyIME(
       HIMC  unnamedParam1,
  [in] DWORD dwAction,
  [in] DWORD dwIndex,
  [in] DWORD dwValue
);

パラメーター

unnamedParam1

[in] dwAction

通知コード。 このパラメーターには、次のいずれかの値を指定できます。

値 意味
NI_CHANGECANDIDATELIST
 アプリケーションによって、現在選択されている候補が変更されました。 dwIndex パラメーターは、選択する候補リストのインデックスを指定し、dwValue は使用されません。
NI_CLOSECANDIDATE
 アプリケーションは、候補リストを閉じるよう IME に指示します。 dwIndex パラメーターは、閉じるリストのインデックスを指定します。dwValue は使用されません。 IME は、リストを閉じると、 IMN_CLOSECANDIDATE コマンドをアプリケーションに送信します。
NI_COMPOSITIONSTR
 アプリケーションは、コンポジション文字列に対してアクションを実行するように IME に指示します。 dwIndex パラメーターには、CPS_CANCEL、CPS_COMPLETE、CPS_CONVERT、またはCPS_REVERTを指定できます。
NI_IMEMENUSELECTED
 アプリケーションは、アプリケーションが指定したメニューを処理できるように IME を指示します。 dwIndex パラメーターはメニューの ID を指定し、dwValue はそのメニュー項目のアプリケーション定義値です。
NI_OPENCANDIDATE
 アプリケーションは、IME に候補リストを開くよう指示します。 dwIndex パラメーターは、開くリストのインデックスを指定します。dwValue は使用されません。 IME は、一覧を開くと、 IMN_OPENCANDIDATE コマンドをアプリケーションに送信します。
NI_SELECTCANDIDATESTR
 アプリケーションが候補の 1 つを選択しました。 dwIndex パラメーターは、選択する候補リストのインデックスを指定します。 dwValue パラメーターは、選択した候補リスト内の候補文字列のインデックスを指定します。
NI_SETCANDIDATE_PAGESIZE
 アプリケーションは、候補リストのページ サイズを変更します。 dwIndex パラメーターは、変更する候補リストを指定し、0 から 3 の範囲の値を持つ必要があります。 dwValue パラメーターは、新しいページ サイズを指定します。
NI_SETCANDIDATE_PAGESTART
 アプリケーションは、候補リストのページ開始インデックスを変更します。 dwIndex パラメーターは、変更する候補リストを指定し、0 から 3 の範囲の値を持つ必要があります。 dwValue パラメーターは、新しいページ開始インデックスを指定します。

[in] dwIndex

候補リストのインデックス。 または、 dwAction がNI_COMPOSITIONSTR場合、このパラメーターには次のいずれかの値を指定できます。

値 意味
CPS_CANCEL
 コンポジション文字列をクリアし、状態をコンポジション文字列なしに設定します。
CPS_COMPLETE
 合成文字列を結果文字列として設定します。
CPS_CONVERT
 コンポジション文字列を変換します。
CPS_REVERT
 現在のコンポジション文字列を取り消し、コンポジション文字列を変換されていない文字列に設定します。

[in] dwValue

候補文字列のインデックス。 アプリケーションでは、 dwAction パラメーターの値に応じて、このパラメーターを設定することも無視することもできます。

戻り値

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

要件

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

こちらもご覧ください

IMN_CLOSECANDIDATE

IMN_OPENCANDIDATE

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

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