ListView_GetStringWidth

This macro determines the width of a specified string, using the specified list view control’s current font. You can use this macro or send the LVM_GETSTRINGWIDTH message explicitly.

At a Glance

Header file: Commctrl.h
Windows CE versions: 1.0 and later
Related message: LVM_GETSTRINGWIDTH

Syntax

int ListView_GetStringWidth( HWND hwnd, LPCSTR psz );

Parameters

hwnd

Handle to the list view control.

psz

Pointer to a null-terminated string.

Return Values

The string width indicates success. Zero indicates failure.

Remarks

The ListView_GetStringWidth macro returns the exact width, in pixels, of the specified string. If you use the returned string width as the column width in a call to the ListView_SetColumnWidth macro, the string will be truncated. To get the column width that can contain the string without truncating it, you must add padding to the returned string width.