LVM_GETSUBITEMRECT message

Retrieves information about the bounding rectangle for a subitem in a list-view control. You can send this message explicitly or by using the ListView_GetSubItemRect macro (recommended). This message is intended to be used only with list-view controls that use the LVS_REPORT style.

Parameters

wParam

Index of the subitem's parent item.

lParam

Pointer to a RECT structure that will receive the subitem bounding rectangle information. Its members must be initialized according to the following member/value relationships:

ValueMeaning
top

The one-based index of the subitem.

left

Flag value (see remarks). Indicates the portion of the list-view subitem for which to retrieve the bounding rectangle.

 

Return value

Returns nonzero if successful, or zero otherwise.

Remarks

Following are the flag values that may be set.

Flag 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 entire item, including the icon and label. This is identical to LVIR_BOUNDS.

 

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

 

 

Show: