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)

另請參閱

輸入方法管理員

輸入方法管理員結構