共用方式為


CListCtrl::GetGroupRect

擷取指定之群組的週框 (Bounding Rectangle) 目前的清單檢視控制項。

BOOL GetGroupRect(
     int iGroupId, 
     LPRECT lpRect, 
     int iCoords = LVGGR_GROUP
) const;

參數

參數

描述

[in] iGroupId

指定群組。

[in, out] lpRect

的長度 結構的指標。 如果此方法成功,結構都會接收 iGroupId指定群組的矩形座標。

[in] iCoords

指定矩形座標擷取。 使用下列其中一個值:

  • LVGGR_GROUP - (整個展開的 群組中的預設值) 座標。

  • LVGGR_HEADER -座標只有標題 (摺疊群組)。

  • LVGGR_SUBSETLINK -座標子集連結 (標記子集)。

傳回值

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);
    }

請參閱

參考

CListCtrl 類別

階層架構圖表

LVM_GETGROUPRECT

的長度