CListCtrl::GetItemIndexRect

项目
03/01/2013

检索一个子项的全部或部分的边框在当前列表视图控件的。

BOOL GetItemIndexRect(
     PLVITEMINDEX pItemIndex, 
     int iColumn, 
     int rectType, 
     LPRECT pRect
) const;

参数

Parameter	说明
[in] pItemIndex	对一 LVITEMINDEX 结构的指针子项的父项目的。调用方负责分配和设置 LVITEMINDEX 结构的成员。此参数不能为 NULL。
[in] iColumn	列的从零开始的索引在控件中。
[in] rectType	边框检索列表视图子项的部分。指定下列值之一： LVIR_BOUNDS -返回整个子项的边框，包括该图标和标签。 LVIR_ICON -返回图标或子项的小图标的边框。 LVIR_LABEL -返回子项文本的边框。
[out] pRect	为获取有关子项的边框的信息的 RECT 结构的指针。调用方负责分配 RECT 结构。此参数不能为 NULL。

返回值

true，则此方法成功;否则，false。

备注

此方法发送 LVM_GETITEMINDEXRECT 信息，在 Windows SDK所述。有关更多信息，请参见 ListView_GetItemIndexRect宏。

要求

标头: afxcmn.h

此控件在 Windows Vista 和更高版本支持。

此方法的其他要求。Windows vista公共控件的生成要求所述。

示例

下面的代码示例定义一个变量，m_listCtrl，用于访问当前列表视图控件。此变量在下一个示例。

public:
    // Variable used to access the list control.
    CListCtrl m_listCtrl;

下面的代码示例演示 GetGroupRect 方法。在输入此代码示例之前我们创建了显示两列标题为“ClientID”和“层”在"报告"视图中的列表视图控件。下面的代码示例在两列的第二个子项周围绘制三维矩形。

    // GetItemIndexRect
    // Get the rectangle that bounds the second item in the first group.
    LVITEMINDEX lvItemIndex;
    lvItemIndex.iGroup = 0;
    lvItemIndex.iItem = 1;
    CRect rect;
    BOOL bRet = m_listCtrl.GetItemIndexRect(
        &lvItemIndex, 0, LVIR_BOUNDS, &rect);

    // Draw a red rectangle around the item.
    m_listCtrl.GetDC()->Draw3dRect( &rect, RGB(255, 0, 0), RGB(255, 0, 0) );