Estrutura TVSORTCB (commctrl.h)

Contém informações usadas para classificar itens filho em um controle de exibição de árvore. Essa estrutura é usada com a mensagem TVM_SORTCHILDRENCB . Essa estrutura é idêntica à estrutura TV_SORTCB , mas foi renomeada para seguir as convenções de nomenclatura atuais.

Sintaxe

typedef struct tagTVSORTCB {
  HTREEITEM    hParent;
  PFNTVCOMPARE lpfnCompare;
  LPARAM       lParam;
} TVSORTCB, *LPTVSORTCB;

Membros

hParent

Tipo: HTREEITEM

Manipule para o item pai.

lpfnCompare

Tipo: PFNTVCOMPARE

Endereço de uma função de retorno de chamada definida pelo aplicativo, que é chamada durante uma operação de classificação sempre que a ordem relativa de dois itens de lista precisa ser comparada.

lParam

Tipo: LPARAM

Valor definido pelo aplicativo que é passado como o argumento lParamSort na função de retorno de chamada especificada em lpfnCompare.

Comentários

A função de retorno de chamada especificada por lpfnCompare tem o seguinte formato:


int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);

A função de retorno de chamada deverá retornar um valor negativo se o primeiro item deve preceder o segundo, um valor positivo se o primeiro item deve seguir o segundo ou zero se os dois itens forem equivalentes.

Os parâmetros lParam1 e lParam2 correspondem ao membro lParam da estrutura TVITEM para os dois itens que estão sendo comparados. O parâmetro lParamSort corresponde ao membro lParam dessa estrutura.

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 commctrl.h