This message arranges items in icon view. You can send this message explicitly or by using the ListView_Arrange macro.

LVM_ARRANGE wParam = (WPARAM)(int) code; lParam = 0;


  • code
    Specifies alignment. It is one of the following values:
    Value Description
    LVA_ALIGNLEFT Not supported.
    LVA_ALIGNTOP Not supported.
    LVA_DEFAULT Aligns items according to the list view control current alignment styles (the default value).
    LVA_SNAPTOGRID Snaps all icons to the nearest grid position.

Return Values

TRUE indicates success. FALSE indicates failure.


Sending a LVM_ARRANGE message to a populated list view control with either of the flags LVA_ALIGNLEFT or LVA_ALIGNTOP does not bring in any change in the way the icons are drawn. This is irrespective of the list view having LVS_ICON or LVS_SMALLICON style. Whatever arrangement style selected at time of creation is what holds when the list view is populated.




Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Commctrl.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

ListView_ApproximateViewRect, ListView_Arrange

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.