COMPAREITEMSTRUCT, structure (winuser.h)

Fournit les identificateurs et les données fournies par l’application pour deux éléments dans une zone de liste ou une zone de liste déroulante triée et dessinée par le propriétaire.

Chaque fois qu’une application ajoute un nouvel élément à une zone de liste dessinée par le propriétaire ou à une zone de liste déroulante créée avec le style CBS_SORT ou LBS_SORT , le système envoie au propriétaire un message WM_COMPAREITEM . Le paramètre lParam du message contient un pointeur long vers une structure COMPAREITEMSTRUCT . Lors de la réception du message, le propriétaire compare les deux éléments et retourne une valeur indiquant quel élément trie avant l’autre.

Syntaxe

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

Membres

CtlType

Type : UINT

ODT_LISTBOX (zone de liste dessinée par le propriétaire) ou ODT_COMBOBOX (zone de liste déroulante dessinée par le propriétaire).

CtlID

Type : UINT

Identificateur de la zone de liste ou de la zone de liste déroulante.

hwndItem

Type : HWND

Handle pour le contrôle.

itemID1

Type : UINT

Index du premier élément de la zone de liste ou de la zone de liste déroulante en cours de comparaison. Ce membre aura la valeur -1 si l’élément n’a pas été inséré ou lors de la recherche d’un élément potentiel dans la zone de liste ou la zone de liste déroulante.

itemData1

Type : ULONG_PTR

Données fournies par l’application pour le premier élément comparé. (Cette valeur a été passée en tant que paramètre lParam du message qui a ajouté l’élément à la zone de liste ou à la zone de liste déroulante.)

itemID2

Type : UINT

Index du deuxième élément de la zone de liste ou de la zone de liste modifiable en cours de comparaison.

itemData2

Type : ULONG_PTR

Données fournies par l’application pour le deuxième élément en cours de comparaison. Cette valeur a été passée en tant que paramètre lParam du message qui a ajouté l’élément à la zone de liste ou à la zone de liste déroulante. Ce membre aura la valeur -1 si l’élément n’a pas été inséré ou lors de la recherche d’un élément potentiel dans la zone de liste ou la zone de liste déroulante.

dwLocaleId

Type : DWORD

Identificateur de paramètres régionaux. Pour créer un identificateur de paramètres régionaux, utilisez la macro MAKELCID .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	winuser.h (inclure Windows.h)

Voir aussi

Zones de liste déroulante

Conceptuel

MAKELCID

Autres ressources

Référence

WM_COMPAREITEM