TVSORTCB-Struktur (commctrl.h)

Enthält Informationen zum Sortieren untergeordneter Elemente in einem Strukturansichtssteuerelement. Diese Struktur wird mit der TVM_SORTCHILDRENCB-Nachricht verwendet. Diese Struktur ist mit der TV_SORTCB-Struktur identisch, wurde jedoch umbenannt, um den aktuellen Benennungskonventionen zu entsprechen.

Syntax

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

Member

hParent

Typ: HTREEITEM

Handle mit dem übergeordneten Element.

lpfnCompare

Typ: PFNTVCOMPARE

Adresse einer anwendungsdefinierte Rückruffunktion, die während eines Sortiervorgangs jedes Mal aufgerufen wird, wenn die relative Reihenfolge von zwei Listenelementen verglichen werden muss.

lParam

Typ: LPARAM

Anwendungsdefinierter Wert, der als lParamSort-Argument in der in lpfnCompare angegebenen Rückruffunktion übergeben wird.

Hinweise

Die von lpfnCompare angegebene Rückruffunktion hat die folgende Form:

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

Die Rückruffunktion muss einen negativen Wert zurückgeben, wenn das erste Element dem zweiten vorangestellt werden soll, einen positiven Wert, wenn das erste Element dem zweiten folgen soll, oder null, wenn die beiden Elemente gleichwertig sind.

Die Parameter lParam1 und lParam2 entsprechen dem lParam-Element der TVITEM-Struktur für die beiden verglichenen Elemente. Der lParamSort-Parameter entspricht dem lParam-Element dieser Struktur.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	commctrl.h