Estructura COMPAREITEMSTRUCT (winuser.h)

Proporciona los identificadores y los datos proporcionados por la aplicación para dos elementos de un cuadro de lista o cuadro combinado ordenado dibujado por el propietario.

Cada vez que una aplicación agrega un nuevo elemento a un cuadro de lista o cuadro combinado dibujado por el propietario creado con el estilo CBS_SORT o LBS_SORT , el sistema envía al propietario un mensaje de WM_COMPAREITEM . El parámetro lParam del mensaje contiene un puntero largo a una estructura COMPAREITEMSTRUCT . Al recibir el mensaje, el propietario compara los dos elementos y devuelve un valor que indica qué elemento ordena antes que el otro.

Sintaxis

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

Miembros

CtlType

Tipo: UINT

Un ODT_LISTBOX (cuadro de lista dibujado por el propietario) o ODT_COMBOBOX (un cuadro combinado dibujado por el propietario).

CtlID

Tipo: UINT

Identificador del cuadro de lista o cuadro combinado.

hwndItem

Tipo: HWND

Identificador del control.

itemID1

Tipo: UINT

Índice del primer elemento del cuadro de lista o cuadro combinado que se va a comparar. Este miembro será –1 si el elemento no se ha insertado o al buscar un elemento potencial en el cuadro de lista o cuadro combinado.

itemData1

Tipo: ULONG_PTR

Datos proporcionados por la aplicación para el primer elemento que se va a comparar. (Este valor se pasó como el parámetro lParam del mensaje que agregó el elemento al cuadro de lista o al cuadro combinado).

itemID2

Tipo: UINT

Índice del segundo elemento del cuadro de lista o cuadro combinado que se compara.

itemData2

Tipo: ULONG_PTR

Datos proporcionados por la aplicación para el segundo elemento que se comparan. Este valor se pasó como parámetro lParam del mensaje que agregó el elemento al cuadro de lista o al cuadro combinado. Este miembro será –1 si el elemento no se ha insertado o al buscar un elemento potencial en el cuadro de lista o cuadro combinado.

dwLocaleId

Tipo: DWORD

El identificador de configuración regional. Para crear un identificador de configuración regional, use la macro MAKELCID .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	winuser.h (incluya Windows.h)

Consulte también

Cuadros combinados

Conceptual

MAKELCID

Otros recursos

Referencia

WM_COMPAREITEM