SftTree/DLL 7.5 - Tree Control

MoveItems

Moves a group of items to a new position in the tree control.

C

int WINAPI SftTree_MoveItems(HWND hwndCtl,
        int from,
        int count,
        int to);
int WINAPI SftTreeSplit_MoveItems(HWND hwndCtl,
        int from,
        int count,
        int to);

C++

int CSftTree::MoveItems(int from,
        int count,
        int to);
int CSftTreeSplit::MoveItems(int from,
        int count,
        int to);

Parameters

hwndCtl

The window handle of the tree control.

from

The zero-based index of the first item to be moved.

count

The number of items to be moved.

to

The zero-based index of the location where the moved items are to be inserted. If to is -1, the items will be added at the end of the list.

Returns

The return value is the number of moved items or -1 if an error occurred.

Comments

The MoveItems function moves a group of items to a new position in the tree control.

MoveItems moves all item attributes, including cell text, pictures, level, row header contents, etc.

An item's dependents are not moved unless they are included in count. If any dependent items are not included in count, they are removed if their parent item is collapsed. They are not removed if the parent item is expanded.

Items can be copied using CopyItems.

In a tree control using a virtual data source, this function cannot be used and an error is returned.

See Also C/C++ API | Categories | Notifications