共用方式為

COMPAREITEMSTRUCT 結構 (winuser.h)

  • 發行項

為已排序、擁有者繪製的清單框或下拉式方塊中的兩個專案提供標識元和應用程式提供的數據。

每當應用程式將新專案新增至以 CBS_SORT 或 LBS_SORT 樣式建立的擁有者繪製清單框或下拉式方塊時，系統就會傳送 WM_COMPAREITEM 訊息給擁有者。 訊息的 lParam 參數包含 COMPAREITEMSTRUCT 結構的長指標。 收到訊息時，擁有者會比較這兩個專案，並傳回值，指出哪些專案在另一個專案之前排序。

語法

typedef struct tagCOMPAREITEMSTRUCT {
  UINT      CtlType;
  UINT      CtlID;
  HWND      hwndItem;
  UINT      itemID1;
  ULONG_PTR itemData1;
  UINT      itemID2;
  ULONG_PTR itemData2;
  DWORD     dwLocaleId;
} COMPAREITEMSTRUCT, *PCOMPAREITEMSTRUCT, *LPCOMPAREITEMSTRUCT;

成員

CtlType

類型： UINT

) 或ODT_COMBOBOX (拥有者绘制下拉式方块) ODT_LISTBOX (拥有者绘制列表框。

CtlID

類型： UINT

清單框或下拉式方塊的標識碼。

hwndItem

類型： HWND

控件的句柄。

itemID1

類型： UINT

要比較的清單框或下拉式方塊中第一個專案的索引。 如果專案尚未插入，或在清單框或下拉式方塊中搜尋潛在專案時，這個成員會是 –1。

itemData1

類型： ULONG_PTR

所比較第一個專案的應用程式提供數據。 (這個值已當做郵件的 lParam 參數傳遞，而該訊息會將專案新增至清單框或下拉式方塊。)

itemID2

類型： UINT

要比較的清單框或下拉式方塊中第二個專案的索引。

itemData2

類型： ULONG_PTR

所比較第二個專案的應用程式提供數據。 這個值會當做訊息的 lParam 參數傳遞，該訊息會將專案新增至清單框或下拉式方塊。 如果專案尚未插入，或在清單框或下拉式方塊中搜尋潛在專案時，這個成員會是 –1。

dwLocaleId

類型： DWORD

地區設定識別碼。 若要建立地區設定標識碼，請使用 MAKELCID 宏。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 winuser.h (包含 Windows.h)

另請參閱

下拉式方塊

概念

MAKELCID

其他資源

參考

WM_COMPAREITEM