CWnd::OnCompareItem

Artigo
08/25/2010

A estrutura chama esta função de membro para especificar a posição relativa de um novo item em uma combinação de proprietário-draw filho classificado ou caixa de listagem.

afx_msg int OnCompareItem(
   int nIDCtl,
   LPCOMPAREITEMSTRUCT lpCompareItemStruct 
);

Parâmetros

nIDCtl
O identificador do controle que enviou o WM_COMPAREITEM mensagem.
lpCompareItemStruct
Contém um ponteiro para um longoCOMPAREITEMSTRUCT estrutura de dados que contém os identificadores e dados fornecidos pelo aplicativo para dois itens na caixa de combinação ou uma lista.

Valor de retorno

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

Valor	Significado
–1	Classifica o item 1 antes de item 2.
0	O item 1 e item 2 classificar o mesmo.
1	Classifica o item 1 após o item 2.

Comentários

Se uma caixa de combinação ou a lista é criada com o CBS_SORT or LBS_SORT estilo, o Windows envia o proprietário da caixa de combinação ou caixa de listagem um WM_COMPAREITEM mensagem sempre que o aplicativo adiciona um novo item.

Dois itens na caixa de combinação ou de lista são reformuladas um COMPAREITEMSTRUCT estrutura apontada por lpCompareItemStruct. OnCompareItem deve retornar um valor que indica qual dos itens deve aparecer antes do Outros. Normalmente, Windows faz essa telefonar várias vezes até que ele determina a posição exata para o novo item.

Se o hwndItem membro do COMPAREITEMSTRUCT estrutura pertence a um CListBox or CComboBox objeto e, em seguida, a CompareItem função virtual da classe apropriada é chamada. Substituir CComboBox::CompareItem ou CListBox::CompareItem no seu derivadas CListBox ou CComboBox classe para fazer a comparação de item.

Observação:
Essa função de membro é chamada pela estrutura para permitir que seu aplicativo manipular uma mensagem do Windows.Os parâmetros passados para sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi ceived.Se você chamar a implementação da classe de base dessa função, essa implementação usará os parâmetros passados originalmente com a mensagem e não os parâmetros que você fornecer para a função.

Essa função de membro é chamada pela estrutura para permitir que seu aplicativo manipular uma mensagem do Windows.Os parâmetros passados para sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi ceived.Se você chamar a implementação da classe de base dessa função, essa implementação usará os parâmetros passados originalmente com a mensagem e não os parâmetros que você fornecer para a função.