Fungsi ImmGetConversionListW (imm.h)

Artikel
11/20/2024

Mengambil daftar hasil konversi karakter atau kata tanpa menghasilkan pesan terkait IME apa pun.

Sintaksis

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

Parameter

unnamedParam1

unnamedParam2

[in] lpSrc

Penunjuk ke string karakter yang dihentikan null yang menentukan sumber daftar.

[out] lpDst

Penunjuk ke struktur CANDIDATELIST tempat fungsi mengambil daftar.

[in] dwBufLen

Ukuran, dalam byte, dari buffer output. Aplikasi mengatur parameter ini ke 0 jika fungsinya adalah mengembalikan ukuran buffer yang diperlukan untuk daftar hasil konversi lengkap.

[in] uFlag

Bendera tindakan. Parameter ini dapat memiliki salah satu nilai berikut.

Nilai	Arti
GCL_CONVERSION	String sumber adalah string bacaan. Fungsi menyalin string hasil ke buffer tujuan.
GCL_REVERSECONVERSION	String sumber adalah string hasil. Fungsi menyalin string baca ke buffer tujuan.
GCL_REVERSE_LENGTH	String sumber adalah string hasil. Fungsi mengembalikan ukuran, dalam byte, dari string bacaan yang dibuat jika GCL_REVERSECONVERSION ditentukan.

Mengembalikan nilai

Mengembalikan jumlah byte yang disalin ke buffer output. Jika aplikasi mengatur parameter dwBufLen ke 0, fungsi mengembalikan ukuran, dalam byte, dari buffer output yang diperlukan.

Komentar

Nota

Header imm.h mendefinisikan ImmGetConversionList sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop],dukungan bahasa Asia Timur terinstal.
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	imm.h (termasuk Immdev.h, Windows.h)
Pustaka	Imm32.lib
DLL	Imm32.dll

Lihat juga

CANDIDATELIST

Manajer Metode Input

Fungsi Manajer Metode Input

Bagikan melalui