LVM_GETSUBITEMRECT

This message retrieves data about the bounding rectangle for a subitem in a list view control. This message is intended to be used only with list view controls that use the LVS_REPORT style.

LVM_GETSUBITEMRECT wParam = (WPARAM)(int) iItem;
lParam = (LPARAM)(LPRECT) lpRect;

Parameters

  • iItem
    Index of the subitem parent item

  • lpRect
    Long pointer to a RECT structure that receives the subitem bounding rectangle data. The members of RECT must be initialized according to the member and value relationships shown in the following table.

    Member Value
    top The one-based index of the subitem
    left Flag value (see following). Indicates the portion of the list view subitem for which to retrieve the bounding rectangle.
    Value Description
    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.

Return Values

Nonzero indicates success. Zero indicates otherwise.

Remarks

Related macro: ListView_GetSubItemRect

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Commctrl.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.