WM_COMPAREITEM訊息

  • 發行項

傳送以判斷新專案在擁有者繪製下拉式方塊或清單方塊的排序清單中之相對位置。 每當應用程式新增新專案時，系統會將此訊息傳送至使用 CBS_SORT 或 LBS_SORT 樣式建立的下拉式方塊或清單方塊的擁有者。

WM_COMPAREITEM

    WPARAM wParam;
    LPARAM lParam;

參數

wParam

指定傳送 WM_COMPAREITEM 訊息之控制項的識別碼。

lParam

COMPAREITEMSTRUCT結構的指標，其中包含下拉式或清單方塊中兩個專案的識別碼和應用程式提供的資料。

傳回值

傳回值表示兩個專案的相對位置。 它可以是下表所示的任何值。

傳回碼 Description
值
 意義
-1
 專案 1 在排序次序中的專案 2 之前。
0
 專案 1 和 2 在排序次序中相等。
1
 專案 1 遵循排序次序中的專案 2。

備註

當擁有者繪製的下拉式方塊或清單方塊的擁有者收到此訊息時，擁有者會傳回值，指出 COMPAREITEMSTRUCT 結構所指定的專案會出現在其他專案之前。 一般而言，系統會傳送此訊息數次，直到它判斷新專案的確切位置為止。

如果對話方塊程式處理此訊息，它應該將所需的傳回值轉換成 BOOL ，並直接傳回值。 系統會忽略 SetWindowLong 函式所設定的DWL_MSGRESULT值。

規格需求

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

另請參閱

參考

COMPAREITEMSTRUCT

其他資源

SetWindowLong