Estructura TVSORTCB (commctrl.h)

Contiene información utilizada para ordenar elementos secundarios en un control de vista de árbol. Esta estructura se usa con el mensaje TVM_SORTCHILDRENCB . Esta estructura es idéntica a la estructura de TV_SORTCB , pero se ha cambiado el nombre para seguir las convenciones de nomenclatura actuales.

Sintaxis

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

Miembros

hParent

Tipo: HTREEITEM

Identificador del elemento primario.

lpfnCompare

Tipo: PFNTVCOMPARE

Dirección de una función de devolución de llamada definida por la aplicación, a la que se llama durante una operación de ordenación cada vez que se debe comparar el orden relativo de dos elementos de lista.

lParam

Tipo: LPARAM

Valor definido por la aplicación que se pasa como argumento lParamSort en la función de devolución de llamada especificada en lpfnCompare.

Comentarios

La función de devolución de llamada especificada por lpfnCompare tiene el siguiente formato:


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

La función de devolución de llamada debe devolver un valor negativo si el primer elemento debe preceder al segundo, un valor positivo si el primer elemento debe seguir el segundo o cero si los dos elementos son equivalentes.

Los parámetros lParam1 y lParam2 corresponden al miembro lParam de la estructura TVITEM para los dos elementos que se comparan. El parámetro lParamSort corresponde al miembro lParam de esta estructura.

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