共用方式為

ImmGetConversionListA 函式 （imm.h）

  • 發行項

擷取字元或單字的轉換結果清單，而不會產生任何與輸入法相關的訊息。

語法

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 預處理器常數的定義，將 ImmGetConversionList 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]，已安裝東亞語言支援。
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 imm.h （包括 Immdev.h、Windows.h）
連結庫 Imm32.lib
DLL Imm32.dll

另請參閱

CANDIDATELIST

Input Method Manager

Input Method Manager 函式