ImmGetConversionListA 関数 (imm.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 に設定すると、関数は必要な出力バッファーのサイズ (バイト単位) を返します。

解説

注意

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

要件

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

関連項目

CANDIDATELIST

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

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