Share via

ListView_GetSubItemRect

  • Article

This macro retrieves information about the rectangle that surrounds a subitem in a list-view control. This macro is intended to be used only on list-view controls that use the LVS_REPORT style.

BOOL ListView_GetSubItemRect( 
  HWND hwndLV, 
  int iItem, 
  int iSubItem, 
  int code, 
  LPRECT lpRect 
);

Parameters

  • hwndLV
    Handle to a list-view control.

  • iItem
    Index of the subitem's parent item.

  • iSubItem
    One-based index of the subitem.

  • code
    Portion of the list-view subitem for which to retrieve the bounding rectangle information. It is one of the following values.

    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.

  • lpRect
    Long pointer to a RECT structure that receives the subitem bounding rectangle information.

Return Values

Nonzero indicates success. Zero indicates otherwise.

Remarks

Related message: LVM_GETSUBITEMRECT

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Commctrl.h.

See Also

LVM_GETSUBITEMRECT | List-View Controls Macros

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.