<Return[I]><Top>

ImmGetProperty

Declare Function Api_ImmGetProperty& Lib "imm32" Alias "ImmGetProperty" (ByVal hkl&, ByVal dw&)

Declare Function ImmGetProperty Lib "imm32" (ByVal hkl As Long, ByVal dw As Long) As Long

指定された入力ロケールに関連付けられている IME のプロパティや機能に関する情報を取得する。

パラメータ
hKL
    入力ロケール識別子を指定する。
fdwIndex
    取得する情報の種類を指定する。次のいずれかの値を指定できる。

    値                                   

取得する情報                            

    IGP_PROPERTY

プロパティ情報

    IGP_CONVERSION

変換関連の機能

    IGP_SENTENCE

変換モードの機能

    IGP_UI

ユーザーインターフェイス関連の機能

    IGP_SETCOMPSTR

変換文字列関連の機能

    IGP_SELECT

選択継承機能

    IGP_GETIMEVERSION

指定した IME に対応するシステムバージョン番号


戻り値
    dwIndex パラメータに指定した値に応じて、プロパティまたは機能の値が返る。

    dwIndex パラメータに IGP_PROPERTY を指定した場合、次の値を組み合わせた戻り値が返る。

    値                                                             

意味                                                                                                           

    IME_PROP_AT_CARET

 

この値がセットされている場合、変換ウィンドウがキャレットの位置にある。クリアされている場合は、キャレットの近くにある。

    IME_PROP_SPECIAL_UI

 

この値がセットされている場合、IME には非標準のインターフェイスがある。アプリケーションから IME ウィンドウ内に描画を行うことはしないこと。

    IME_PROP_CANDLIST_START_FROM_1

 

この値がセットされている場合、候補一覧に示されている文字列の番号は 1 から始まる。

クリアされている場合は、0 から始まる。

    IME_PROP_UNICODE

 

 

この値がセットされている場合、IME は Unicode IME として表示され、IME とシステムは

Unicode IME インターフェイスを介して通信する。クリアされている場合、IME は ANSI インターフェイスを使ってシステムと通信する。

    IME_PROP_COMPLETE_ON_UNSELECT

 

 

この値がセットされている場合、IME がアクティブでなくなったときに、変換文字列が確定される。クリアされている場合、IME がアクティブでなくなったときに( キーボードレイアウト

の変更などにより)、変換文字列は取り消される。

    IME_PROP_ACCEPT_WIDE_VKEY

 

 

 

Windows 2000:この値がセットされている場合、IME は VK_PACKET を使って

SendInput 関数から送られて来た Unicode( インジェクトされた Unicode)を処理する。

クリアされている場合、IME はインジェクトされた Unicode を処理できず、そのため、インジェクトされた Unicode は直接アプリケーションへ送られる可能性がある。

    dwIndex パラメータに IGP_UI を指定した場合、次の値を組み合わせた戻り値が返る。

    値                             

意味                                                                                                                                      

    UI_CAP_2700

0 または 2700 のテキストエスケープメント値(10 分の 1 度単位の文字送りの方向)をサポートする。

    UI_CAP_ROT90

0、900、1800、2700 のテキストエスケープメント値をサポートする。

    UI_CAP_ROTANY

任意のテキストエスケープメント値をサポートする。

    dwIndex パラメータに IGP_SETCOMPSTR を指定した場合、次の値を組み合わせた戻り値が返る。

    値                                                      

意味                                                                      

    SCS_CAP_COMPSTR

 

ImmSetCompositionString 関数を SCS_SETSTR 値を指定して呼び出すことにより、変換文

字列を生成できる。

    SCS_CAP_MAKEREAD

 

ImmSetCompositionString 関数を SCS_SETSTR を指定して呼び出した場合に、対応する変

換文字列から読み文字列を生成することができる。

    SCS_CAP_SETRECONVERTSTRING

 

この IME は逆変換をサポートしている。逆変換を行うには、IMMSetCompositionString 関数を

使う。

    dwIndex パラメータに IGP_SELECT を指定した場合、次の値を組み合わせた戻り値が返る。

    値                                            

意味                                                                          

    SELECT_CAP_CONVMODE

新しい IME が選択されたときに、入力モードを継承する。

    SELECT_CAP_SENTENCE

新しい IME が選択されたときに、変換モードを継承する。

    dwIndex パラメータに IGP_GETIMEVERSION を指定した場合は、次の値のいずれかが返る。

    値                         

意味                                        

    IMEVER_0310

Windows 3.1 用に作成された IME。

    IMEVER_0400

Windows 95 用に作成された IME。