ListView_GetItemRect

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This macro retrieves the bounding rectangle for all or part of an item in the current view. You can use this macro or send the LVM_GETITEMRECT message explicitly.

Syntax

BOOL ListView_GetItemRect( 
  HWND hwnd, 
  int i, 
  RECT FAR* prc, 
  int code 
);

Parameters

  • hwnd
    Handle to the list-view control.
  • i
    Index of the list-view item.
  • prc
    Pointer to a RECT structure that receives the bounding rectangle. When the LVM_GETITEMRECT message is sent, the left member of this structure contains the value of the code parameter.
  • code
    Portion of the list-view item for which to retrieve the bounding rectangle. 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 item text.

    LVIR_SELECTBOUNDS

    Returns the union of the LVIR_ICON and LVIR_LABEL rectangles, but excludes columns in details view.

Return Value

TRUE indicates success. FALSE indicates failure.

Remarks

Related message: LVM_GETITEMRECT

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

LVM_GETITEMRECT
List-View Controls Macros