<Return[I]><Top>

ImmNotifyIME

Declare Function Api_ImmNotifyIME& Lib "imm32" Alias "ImmNotifyIME" (ByVal hIMC&, ByVal dwAction&, ByVal dwIndex&, ByVal dwValue&)

Declare Function ImmNotifyIME Lib "imm32" Alias "ImmNotifyIME" (ByVal hIMC As Long, ByVal dwAction As Long, ByVal dwIndex As Long, ByVal dwValue As Long) As Long

入力コンテキストの状態の変更に関する情報を IME に知らせる。

パラメータ
hIMC
    入力コンテキストのハンドルを指定する。
dwAction
    通知コードを指定する。このパラメータには、次のいずれかの値を指定できる。

    値                                                    

意味                                                                                                                   

    NI_CHANGECANDIDATELIST

 

選択されている候補一覧を変更する。dwIndex パラメータには、選択する候補一覧のインデックスを指定し、dwValue パラメータには何も指定しない。

    NI_CLOSECANDIDATE

 

 

IME に、候補一覧を閉じるように指示する。dwIndex パラメータには、閉じる一覧のインデックスを指定し、dwValue パラメータには何も指定しない。IME は、一覧を閉じたらアプリケーションに メッセージを送信する。

    NI_COMPOSITIONSTR

 

 

IME に、変換文字列に対する処理を実行するように指示する。dwValue パラメータには何も指定しない。DwIndex パラメータには、CPS_CANCEL、CPS_COMPLETE、CPS_CONVERT、CPS_REVERT のいずれかを指定する。

    NI_IMEMENUSELECTED

 

 

IME に、指定したメニューを処理することをアプリケーションに許可するよう指示する。dwIndex パラメータにはメニューの ID を指定し、dwValue パラメータにはそのメニュー項目用のアプリケーション定義の値を指定する。

    NI_OPENCANDIDATE

 

 

IME に、候補一覧を開くように指示する。dwIndex パラメータには、開く一覧のインデックスを指定する。DwValue パラメータには、何も指定しない。IME は、一覧を開いたらアプリケーションに メッセージを送信する。

    NI_SELECTCANDIDATESTR

 

変換候補の 1 つを選択する。dwIndex パラメータには、対象とする候補一覧のインデックスを指定する。dwValue パラメータには、その候補一覧での候補文字列のインデックスを指定する。

    NI_SETCANDIDATE_PAGESIZE

 

dwIndex パラメータには、変更する候補一覧を指定する。0〜3 の範囲内の値を指定しなければならない。

    NI_SETCANDIDATE_PAGESTART

dwIndex パラメータには、変更する候補一覧を指定する。0〜3 の範囲内の値を指定しなければならない。

dwIndex
    候補一覧のインデックスを指定する。dwAction パラメータに NI_COMPOSITIONSTR を指定した場合は、次のいずれかの値を指定す

    る。

    値                          

意味                                                                            

    CPS_CANCEL

変換文字列を消去し、状態を変換文字列なしに設定する。

    CPS_COMPLETE

現在の変換文字列を変換結果として確定する。

    CPS_CONVERT

変換文字列を変換する。

    CPS_REVERT

現在の変換文字列を取り消し、未変換文字列に戻す。

dwValue
    dwAction パラメータに指定した値に応じて、候補文字列のインデックスを指定するか、または何も指定しない。

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。