Struktur CANDIDATELIST (imm.h)
Berisi informasi tentang daftar kandidat.
Sintaks
typedef struct tagCANDIDATELIST {
DWORD dwSize;
DWORD dwStyle;
DWORD dwCount;
DWORD dwSelection;
DWORD dwPageStart;
DWORD dwPageSize;
DWORD dwOffset[1];
} CANDIDATELIST, *PCANDIDATELIST, *NPCANDIDATELIST, *LPCANDIDATELIST;
Anggota
dwSize
Ukuran, dalam byte, struktur, array offset, dan semua string kandidat.
dwStyle
Nilai gaya kandidat. Anggota ini bisa memiliki satu atau beberapa nilai berikut.
| Nilai | Makna |
|---|---|
| IME_CAND_UNKNOWN | Kandidat dalam gaya selain yang tercantum di sini. |
| IME_CAND_READ | Kandidat berada dalam pembacaan yang sama. |
| IME_CAND_CODE | Kandidat berada dalam rentang kode. |
| IME_CAND_MEANING | Kandidat dalam arti yang sama. |
| IME_CAND_RADICAL | Kandidat menggunakan karakter radikal yang sama. |
| IME_CAND_STROKES | Kandidat dalam jumlah stroke yang sama. |
Untuk gaya IME_CAND_CODE, daftar kandidat memiliki struktur khusus tergantung pada nilai anggota dwCount . Jika dwCount adalah 1, anggota dwOffset berisi satu karakter DBCS daripada offset, dan tidak ada string kandidat yang disediakan. Jika anggota dwCount lebih besar dari 1, anggota dwOffset berisi offset yang valid, dan string kandidat adalah representasi teks dari nilai karakter DBCS individu dalam notasi heksadesimal.
dwCount
Jumlah string kandidat.
dwSelection
Indeks string kandidat yang dipilih.
dwPageStart
Indeks string kandidat pertama di jendela kandidat. Ini bervariasi saat pengguna menekan tombol PAGE UP dan PAGE DOWN.
dwPageSize
Jumlah string kandidat yang akan ditampilkan dalam satu halaman di jendela kandidat. Pengguna dapat berpindah ke halaman berikutnya dengan menekan tombol yang ditentukan IME, seperti tombol PAGE UP atau PAGE DOWN. Jika angka ini adalah 0, aplikasi dapat menentukan nilai yang tepat dengan sendirinya.
dwOffset[1]
Offset ke awal string kandidat pertama, relatif terhadap awal struktur ini. Offset untuk string berikutnya segera mengikuti anggota ini, membentuk array offset 32-bit.
Keterangan
String kandidat segera mengikuti offset terakhir dalam array dwOffset .
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Header | imm.h (termasuk Immdev.h, Windows.h) |