Compartilhar via


CWnd::OnCompareItem

A estrutura chama essa função de membro para especificar a posição relativa de um novo item em um proprietário classificado filho ou combinado na caixa de listagem.

afx_msg int OnCompareItem( 
   int nIDCtl, 
   LPCOMPAREITEMSTRUCT lpCompareItemStruct  
);

Parâmetros

  • nIDCtl
    O identificador do controle que enviou a mensagem de WM_COMPAREITEM .

  • lpCompareItemStruct
    Contém um ponteiro ao longo um estrutura de dados de COMPAREITEMSTRUCT que contém os identificadores aplicativo e os dados fornecidos para dois itens em combinados ou na caixa de listagem.

Valor de retorno

Indica a posição relativa dos dois itens. Pode ser qualquer um dos seguintes valores:

Valor

Significado

–1

Tipos de item 1 antes de item 2.

0

Tipo de item de item 1 e 2 o mesmo.

1

Tipos de item 1 após o item 2.

Comentários

Se um for combinado ou caixa de listagem são criados com o estilo de CBS_SORT ou de LBS_SORT , janelas envia o proprietário da caixa de combinação ou da caixa de listagem uma mensagem de WM_COMPAREITEM sempre que o aplicativo adicionar um novo item.

Dois itens ou combinado na caixa de listagem são reformados em uma estrutura de COMPAREITEMSTRUCT apontada por lpCompareItemStruct. OnCompareItem deve retornar um valor que indica um de eles deve aparecer antes de outro. Normalmente, o windows tornam a esta chamada várias vezes até que determina a posição exata para o novo item.

Se o membro de hwndItem estrutura de COMPAREITEMSTRUCT pertence a CListBox ou objeto de CComboBox , então a função virtual de CompareItem da classe apropriada será chamada. Substituição CComboBox::CompareItem ou CListBox::CompareItem em sua CListBox ou classe derivada de CComboBox para fazer a comparação de item.

Dica

Essa função de membro é chamada pela estrutura para permitir que seu aplicativo manipule uma mensagem do windows.Parâmetros passados à sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi colocada.Se você chamar a implementação da classe base de essa função, essa implementação usará parâmetros passados originalmente com a mensagem e não os parâmetros que você fornece para a função.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico da hierarquia

Estrutura COMPAREITEMSTRUCT

WM_COMPAREITEM

CListBox::CompareItem

CComboBox::CompareItem