LVM_GETITEMRECT message

Retrieves the bounding rectangle for all or part of an item in the current view. You can send this message explicitly or by using the ListView_GetItemRect macro.

Parameters

wParam [in]

Index of the list-view item.

lParam [in, out]

Pointer to a RECT structure that receives the bounding rectangle. When the message is sent, the left member of this structure is used to specify the portion of the list-view item from which to retrieve the bounding rectangle. It must be set to one of the following values:

Value Meaning
LVIR_BOUNDS
Returns the bounding rectangle of the entire item, including the icon and label.
LVIR_ICON
Returns the bounding rectangle of the icon or small icon.
LVIR_LABEL
Returns the bounding rectangle of the item text.
LVIR_SELECTBOUNDS
Returns the union of the LVIR_ICON and LVIR_LABEL rectangles, but excludes columns in report view.

Return value

Returns TRUE if successful, or FALSE otherwise.

Requirements

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