ImmGetConversionListA 関数 (immdev.h)

IME 関連のメッセージを生成せずに、文字または単語の変換結果リストを取得します。

構文

DWORD ImmGetConversionListA(
        HKL             unnamedParam1,
        HIMC            unnamedParam2,
  [in]  LPCSTR          lpSrc,
  [out] LPCANDIDATELIST lpDst,
  [in]  DWORD           dwBufLen,
  [in]  UINT            uFlag
);

パラメーター

unnamedParam1

unnamedParam2

[in] lpSrc

リストのソースを指定する null で終わる文字列へのポインター。

[out] lpDst

関数がリストを取得する CANDIDATELIST 構造体へのポインター。

[in] dwBufLen

出力バッファーのサイズ (バイト単位)。 関数が完全な変換結果リストに必要なバッファー サイズを返す場合、アプリケーションはこのパラメーターを 0 に設定します。

[in] uFlag

アクション フラグ。 このパラメーターには、次のいずれかの値を指定できます。

意味
GCL_CONVERSION
ソース文字列は読み取り文字列です。 関数は、結果文字列をコピー先バッファーにコピーします。
GCL_REVERSECONVERSION
ソース文字列は結果文字列です。 関数は、読み取り文字列をコピー先バッファーにコピーします。
GCL_REVERSE_LENGTH
ソース文字列は結果文字列です。 関数は、GCL_REVERSECONVERSIONが指定されている場合に作成された読み取り文字列のサイズをバイト単位で返します。

戻り値

出力バッファーにコピーされたバイト数を返します。 アプリケーションで dwBufLen パラメーターを 0 に設定すると、関数は必要な出力バッファーのサイズ (バイト単位) を返します。

注釈

注意

immdev.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして ImmGetConversionList を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

こちらもご覧ください

CANDIDATELIST

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

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