Estrutura COMPAREITEMSTRUCT (winuser.h)

Fornece os identificadores e os dados fornecidos pelo aplicativo para dois itens em uma caixa de listagem ou caixa de combinação classificada, desenhada pelo proprietário.

Sempre que um aplicativo adiciona um novo item a uma caixa de listagem ou caixa de combinação desenhada pelo proprietário criada com o estilo CBS_SORT ou LBS_SORT , o sistema envia ao proprietário uma mensagem WM_COMPAREITEM . O parâmetro lParam da mensagem contém um ponteiro longo para uma estrutura COMPAREITEMSTRUCT . Ao receber a mensagem, o proprietário compara os dois itens e retorna um valor que indica qual item classifica antes do outro.

Sintaxe

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

Membros

CtlType

Tipo: UINT

Um ODT_LISTBOX (caixa de listagem desenhada pelo proprietário) ou ODT_COMBOBOX (uma caixa de combinação desenhada pelo proprietário).

CtlID

Tipo: UINT

O identificador da caixa de listagem ou caixa de combinação.

hwndItem

Tipo: HWND

Um identificador para o controle.

itemID1

Tipo: UINT

O índice do primeiro item na caixa de listagem ou caixa de combinação que está sendo comparada. Esse membro será –1 se o item não tiver sido inserido ou ao pesquisar um item potencial na caixa de listagem ou caixa de combinação.

itemData1

Tipo: ULONG_PTR

Dados fornecidos pelo aplicativo para o primeiro item que está sendo comparado. (Esse valor foi passado como o parâmetro lParam da mensagem que adicionou o item à caixa de listagem ou caixa de combinação.)

itemID2

Tipo: UINT

O índice do segundo item na caixa de listagem ou caixa de combinação que está sendo comparada.

itemData2

Tipo: ULONG_PTR

Dados fornecidos pelo aplicativo para o segundo item que está sendo comparado. Esse valor foi passado como o parâmetro lParam da mensagem que adicionou o item à caixa de listagem ou caixa de combinação. Esse membro será –1 se o item não tiver sido inserido ou ao pesquisar um item potencial na caixa de listagem ou caixa de combinação.

dwLocaleId

Tipo: DWORD

O identificador de localidade. Para criar um identificador de localidade, use a macro MAKELCID .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	winuser.h (inclua Windows.h)

Confira também

Caixas de combinação

Conceitual

MAKELCID

Outros recursos

Referência

WM_COMPAREITEM