ListView_SetColumnWidth macro (commctrl.h)

Article
10/23/2024

Used to change the width of a column in report view or the width of all columns in list-view mode. You can use this macro or send the LVM_SETCOLUMNWIDTH message explicitly.

Syntax

BOOL ListView_SetColumnWidth(
   HWND hwnd,
   int  iCol,
   int  cx
);

Parameters

hwnd

Type: HWND

A handle to the list-view control.

iCol

Type: int

The zero-based index of a valid column. For list-view mode, this parameter must be set to zero.

cx

Type: int

The new width of the column, in pixels. For report-view mode, the following special values are supported:

Value	Meaning
LVSCW_AUTOSIZE	Automatically sizes the column.
LVSCW_AUTOSIZE_USEHEADER	Automatically sizes the column to fit the header text. If you use this value with the last column, its width is set to fill the remaining width of the list-view control.

Return value

Type: BOOL

Returns TRUE if successful, or FALSE otherwise.

Remarks

Assume that you have a 2-column list-view control with a width of 500 pixels. If the width of column zero is set to 200 pixels, and you make the following call.

ListView_SetColumnWidth(hwnd, 1, LVSCW_AUTOSIZE_USEHEADER)

The second (and last) column will be 300 pixels wide.

Note that ListView_SetColumnWidth converts the cx parameter to a 16-bit value.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	commctrl.h

Share via