Share via

LVM_ARRANGE

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

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.
  • lParam
    Not used.

Return Value

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 behavior occurs regardless of whether the list view has the LVS_ICON or LVS_SMALLICON style. Whatever arrangement style selected at time of creation is what holds when the list view is populated.

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ListView_ApproximateViewRect
ListView_Arrange
List-View Controls Messages