COMPAREITEMSTRUCT-Struktur (winuser.h)

Stellt die Bezeichner und von der Anwendung bereitgestellten Daten für zwei Elemente in einem sortierten, vom Besitzer gezeichneten Listenfeld oder Kombinationsfeld bereit.

Wenn eine Anwendung ein neues Element zu einem vom Besitzer gezeichneten Listenfeld oder Kombinationsfeld hinzufügt, das mit dem CBS_SORT - oder LBS_SORT-Format erstellt wurde, sendet das System dem Besitzer eine WM_COMPAREITEM Nachricht. Der lParam-Parameter der Nachricht enthält einen langen Zeiger auf eine COMPAREITEMSTRUCT-Struktur . Beim Empfang der Nachricht vergleicht der Besitzer die beiden Elemente und gibt einen Wert zurück, der angibt, welches Element vor dem anderen sortiert wird.

Syntax

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

Member

CtlType

Typ: UINT

Ein ODT_LISTBOX (vom Besitzer gezeichnetes Listenfeld) oder ODT_COMBOBOX (ein vom Besitzer gezeichnetes Kombinationsfeld).

CtlID

Typ: UINT

Der Bezeichner des Listen- oder Kombinationsfelds.

hwndItem

Typ: HWND

Ein Handle für das Steuerelement.

itemID1

Typ: UINT

Der Index des ersten Elements im Listenfeld oder Kombinationsfeld, das verglichen wird. Dieser Member ist –1, wenn das Element nicht eingefügt wurde oder wenn ein potenzielles Element im Listenfeld oder Kombinationsfeld gesucht wird.

itemData1

Typ: ULONG_PTR

Von der Anwendung bereitgestellte Daten für das erste Element, das verglichen wird. (Dieser Wert wurde als lParam-Parameter der Nachricht übergeben, die das Element dem Listenfeld oder Kombinationsfeld hinzugefügt hat.)

itemID2

Typ: UINT

Der Index des zweiten Elements im Listenfeld oder Kombinationsfeld, das verglichen wird.

itemData2

Typ: ULONG_PTR

Anwendungsbezogene Daten für das zweite Element, das verglichen wird. Dieser Wert wurde als lParam-Parameter der Nachricht übergeben, die das Element dem Listenfeld oder Kombinationsfeld hinzugefügt hat. Dieser Member ist –1, wenn das Element nicht eingefügt wurde oder wenn ein potenzielles Element im Listenfeld oder Kombinationsfeld gesucht wird.

dwLocaleId

Typ: DWORD

Der Gebietsschemabezeichner. Verwenden Sie zum Erstellen eines Gebietsschemabezeichners das MAKELCID-Makro .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winuser.h (einschließlich Windows.h)

Weitere Informationen

Kombinationsfelde

Konzept

MAKELCID

Andere Ressourcen

Referenz

WM_COMPAREITEM