ListView_SetIconSpacing

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

At a Glance

Header file: Commctrl.h
Windows CE versions: 2.0 and later
Related message: LVM_SETICONSPACING

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 Values

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.