<Return[I]><Top>

ImmGetConversionList

Declare Function Api_ImmGetConversionList& Lib "imm32" Alias "ImmGetConversionListA" (ByVal hkl&, ByVal hIMC&, ByVal lpSrc$, lpDst As CANDIDATELIST, ByVal dwBufLen&, ByVal uFlag&)

Declare Function ImmGetConversionList Lib "imm32" Alias "ImmGetConversionListA" (ByVal hkl As Long, ByVal hIMC As Long, ByVal lpSrc As String, lpDst As CANDIDATELIST, ByVal dwBufLen As Long, ByVal uFlag As Long) As Long

IME 関連のメッセージを一切生成せずに、文字または単語の変換結果一覧を取得する。

パラメータ
hKL
    入力ロケール識別子を指定する。
hIMC
    入力コンテキストのハンドルを指定する。
lpSrc
    NULL で終わるソース文字列(変換対象となる文字列)へのポインタを指定する。
lpDst
    変換結果を受け取る CANDIDATELIST 構造体へのポインタを指定する。
dwBufLen
    変換結果を受け取るバッファのサイズをバイト単位で指定する。このパラメータに 0 を指定すると、要求した変換結果をすべて受け取るため

    に必要となるバッファサイズが関数から返る。
uFlag
    アクションフラグを指定する。このパラメータには、次のいずれかの値を指定できる。

    値                                              

意味                                                                                                                               

    GCL_CONVERSION

　

ソース文字列は、読み文字列である。このソース文字列を変換して得られた変換結果が指定したバッファにコピーされる。

    GCL_REVERSECONVERSION

　

ソース文字列は、変換結果である。ソース文字列を逆変換して得られた読み文字列が指定したバッファにコピーされる。

    GCL_REVERSE_LENGTH

　

ソース文字列は、変換結果である。GCL_REVERSECONVERSION を指定した場合に生成される読み文字列のバイト単位での長さが関数から返る。


戻り値
    指定したバッファにコピーされたデータのバイト数が返る。dwBufLen パラメータに 0 を指定した場合は、要求した情報を受け取るために必要

    となるバッファサイズが返る。