STRUKTUR COMPAREITEMSTRUCT (winuser.h)

Menyediakan pengidentifikasi dan data yang disediakan aplikasi untuk dua item dalam kotak daftar atau kotak kombo yang diurutkan dan digambar pemilik.

Setiap kali aplikasi menambahkan item baru ke kotak daftar yang digambar pemilik atau kotak kombo yang dibuat dengan gaya CBS_SORT atau LBS_SORT , sistem mengirim pesan WM_COMPAREITEM kepada pemilik. Parameter lParam pesan berisi pointer panjang ke struktur COMPAREITEMSTRUCT . Setelah menerima pesan, pemilik membandingkan dua item dan mengembalikan nilai yang menunjukkan item mana yang mengurutkan sebelum item lainnya.

Sintaks

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

Anggota

CtlType

Jenis: UINT

ODT_LISTBOX (kotak daftar yang digambar pemilik) atau ODT_COMBOBOX (kotak kombo yang digambar pemilik).

CtlID

Jenis: UINT

Pengidentifikasi kotak daftar atau kotak kombo.

hwndItem

Jenis: HWND

Handel ke kontrol.

itemID1

Jenis: UINT

Indeks item pertama dalam kotak daftar atau kotak kombo sedang dibandingkan. Anggota ini akan menjadi –1 jika item belum disisipkan atau saat mencari item potensial dalam kotak daftar atau kotak kombo.

itemData1

Jenis: ULONG_PTR

Data yang disediakan aplikasi untuk item pertama dibandingkan. (Nilai ini diteruskan sebagai parameter lParam dari pesan yang menambahkan item ke kotak daftar atau kotak kombo.)

itemID2

Jenis: UINT

Indeks item kedua dalam kotak daftar atau kotak kombo sedang dibandingkan.

itemData2

Jenis: ULONG_PTR

Data yang disediakan aplikasi untuk item kedua dibandingkan. Nilai ini diteruskan sebagai parameter lParam dari pesan yang menambahkan item ke kotak daftar atau kotak kombo. Anggota ini akan menjadi –1 jika item belum disisipkan atau saat mencari item potensial dalam kotak daftar atau kotak kombo.

dwLocaleId

Jenis: DWORD

Pengidentifikasi lokal. Untuk membuat pengidentifikasi lokal, gunakan makro MAKELCID .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	winuser.h (termasuk Windows.h)

Lihat juga

Kotak Kombo

Konseptual

MAKELCID

Sumber Daya Lain

Referensi

WM_COMPAREITEM