ListView_SetIconSpacing

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This macro sets the spacing between icons in list-view controls set to the LVS_ICON style.

Syntax

DWORD ListView_SetIconSpacing(
  HWND hwndLV, 
  int cx, 
  int cy 
);

Parameters

  • hwndLV
    Handle to a list-view control.
  • cx
    Distance, in pixels, to set between icons on the x-axis.
  • cy
    Distance, in pixels, to set between icons on the y-axis.

Return Value

Returns a DWORD value that contains the previous cx in the low-order word, and the previous cy in the high-order word.

Remarks

The cx and cy parameters are relative to the upper-left corner of an icon bitmap. Therefore, to set spacing between icons that do not overlap, the cx or cy values must include the size of the icon, plus the amount of empty space desired between icons. Values that do not include the width of the icon will result in overlaps.

Related message: LVM_SETICONSPACING

Requirements

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

See Also

Reference

LVM_SETICONSPACING
List-View Controls Macros