CListCtrl::GetGroupRect
检索指定的组的边框当前列表视图控件的。
BOOL GetGroupRect(
int iGroupId,
LPRECT lpRect,
int iCoords = LVGGR_GROUP
) const;
参数
Parameter |
说明 |
|---|---|
[in] iGroupId |
指定组。 |
[in，out] lpRect |
为 RECT 结构的指针。 如果此方法成功，结构接收由 iGroupId指定组的矩形坐标。 |
[in] iCoords |
指定矩形坐标检索。 使用这些值之一：
|
返回值
true，则此方法成功;否则，false。
备注
调用方负责分配 RECT 结构指向由 pRect 参数。
此方法发送 LVM_GETGROUPRECT 信息，在 Windows SDK所述。
要求
标头: afxcmn.h
此控件在 Windows Vista 和更高版本支持。
此方法的其他要求。Windows vista公共控件的生成要求所述。
示例
下面的代码示例定义一个变量，m_listCtrl，用于访问当前列表视图控件。 此变量在下一个示例。
public:
// Variable used to access the list control.
CListCtrl m_listCtrl;
下面的代码示例演示 GetGroupRect 方法。 此代码示例的早期节中，我们创建了显示两列标题为“ClientID”和“层”在"报告"视图中的列表视图控件。 下面的代码示例在索引为0的组周围绘制三维矩形，;如果该组存在。
// GetGroupRect
// Get the graphics rectangle that surrounds group 0.
CRect rect;
BOOL bRet = m_listCtrl.GetGroupRect( 0, &rect, LVGGR_GROUP);
// Draw a blue rectangle around group 0.
if (bRet == TRUE) {
m_listCtrl.GetDC()->Draw3dRect( &rect, RGB(0, 0, 255), RGB(0, 0, 255));
}
else {
AfxMessageBox(_T("No group information was retrieved."), MB_ICONINFORMATION);
}