TreeView_SortChildrenCB macro (commctrl.h)

Sorts tree-view items using an application-defined callback function that compares the items. You can use this macro or send the TVM_SORTCHILDRENCB message explicitly.

Syntax

BOOL TreeView_SortChildrenCB(
   HWND       hwnd,
   LPTVSORTCB psort,
   BOOL       recurse
);

Parameters

hwnd

Type: HWND

Handle to the tree-view control.

psort

Type: LPTVSORTCB

Pointer to a TVSORTCB structure. The lpfnCompare member is the address of the application-defined callback function, which is called during the sort operation each time the relative order of two list items needs to be compared. For more information about the callback function, see the description of TVSORTCB.

recurse

Type: BOOL

Reserved. Must be zero.

Return value

Type: BOOL

Returns TRUE if successful, or FALSE otherwise.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header commctrl.h