LVM_SETITEMPOSITION message

Moves an item to a specified position in a list-view control (must be in icon or small icon view). You can send this message explicitly or by using the ListView_SetItemPosition macro.

Parameters

wParam

Index of the list-view item.

lParam

The LOWORD specifies the new x-position of the item's upper-left corner, in view coordinates. The HIWORD specifies the new y-position of the item's upper-left corner, in view coordinates.

Return value

Returns TRUE if successful, or FALSE otherwise.

Remarks

If the list-view control has the LVS_AUTOARRANGE style, the items in the list-view control are arranged after the position of the item is set.

On Windows Vista, sending this message to a list-view control with the LVS_AUTOARRANGE style does nothing, and the return value is FALSE.

Requirements

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