CListCtrl::GetGroupRect
擷取指定之群組的週框 (Bounding Rectangle) 目前的清單檢視控制項。
BOOL GetGroupRect(
int iGroupId,
LPRECT lpRect,
int iCoords = LVGGR_GROUP
) const;
參數
參數 |
描述 |
|---|---|
[in] iGroupId |
指定群組。 |
[in， out] lpRect |
為 的長度 結構的指標。 如果此方法成功，結構都會接收 iGroupId指定群組的矩形座標。 |
[in] iCoords |
指定矩形座標擷取。 使用下列其中一個值:
|
傳回值
true ，如果此方法成功，否則， false。
備註
呼叫端會負責配置 的長度 結構所指向的 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 的群組周圍繪製 3D 矩形，則為，如果此群組的話)。
// 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);
}