CANDIDATELIST 結構 (imm.h)
包含候選清單的相關資訊。
語法
typedef struct tagCANDIDATELIST {
DWORD dwSize;
DWORD dwStyle;
DWORD dwCount;
DWORD dwSelection;
DWORD dwPageStart;
DWORD dwPageSize;
DWORD dwOffset[1];
} CANDIDATELIST, *PCANDIDATELIST, *NPCANDIDATELIST, *LPCANDIDATELIST;
成員
dwSize
大小，以位元組為單位，結構、位移陣列和所有候選字串。
dwStyle
候選樣式值。 這個成員可以有下列一或多個值。
| 值 | 意義 |
|---|---|
| IME_CAND_UNKNOWN | 候選項目是此處所列的樣式。 |
| IME_CAND_READ | 候選項目在相同的讀取中。 |
| IME_CAND_CODE | 候選項目位於程式碼範圍內。 |
| IME_CAND_MEANING | 候選項目的意義相同。 |
| IME_CAND_RADICAL | 候選項目使用相同的根字元。 |
| IME_CAND_STROKES | 候選項目的數目相同。 |
針對IME_CAND_CODE樣式，候選清單有特殊結構，視 dwCount 成員的值而定。 如果 dwCount 為 1， dwOffset 成員會包含單一 DBCS 字元，而不是位移，而且未提供候選字串。 如果 dwCount 成員大於 1， dwOffset 成員會包含有效的位移，而候選字串則是十六進位標記法中個別 DBCS 字元值的文字標記法。
dwCount
候選字串的數目。
dwSelection
選取候選字串的索引。
dwPageStart
候選視窗中第一個候選字串的索引。 這會隨著使用者按下 PAGE UP 和 PAGE DOWN 鍵而有所不同。
dwPageSize
要顯示在候選視窗中一頁的候選字串數目。 使用者可以按 IME 定義的按鍵來移至下一頁，例如 PAGE UP 或 PAGE DOWN 鍵。 如果這個數位是 0，應用程式可以自行定義適當的值。
dwOffset[1]
相對於這個結構的開頭，位移至第一個候選字串的開頭。 後續字串的位移會緊接在這個成員後面，形成 32 位位移的陣列。
備註
候選字串會緊接 在 dwOffset 陣列的最後一個位移之後。
需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 | imm.h (包括 Immdev.h、Windows.h) |