LVM_ARRANGE

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

At a Glance

Header file: Commctrl.h
Windows CE versions: 1.0 and later
Related macro: ListView_Arrange

Syntax

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

Parameters

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.

Remarks

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.