CListCtrl::GetGroupRect
Načte ohraničovací obdélník pro zadanou skupinu v ovládacím prvku aktuální zobrazení seznamu.
BOOL GetGroupRect(
int iGroupId,
LPRECT lpRect,
int iCoords = LVGGR_GROUP
) const;
Parametry
Parametr |
Description |
|---|---|
[v]iGroupId |
Určuje skupinu. |
[v, out]lpRect |
Ukazatel RECT struktury.Pokud je tato metoda úspěšná, struktura obdrží souřadnice obdélníku skupiny, který je určen iGroupId . |
[v]iCoords |
Určuje načíst souřadnice obdélníku.Použijte jeden z těchto hodnot:
|
Vrácená hodnota
truePokud je tato metoda úspěšná. jinak false .
Poznámky
Volající je odpovědný za přidělení RECT struktury odkazuje pRect parametr.
Tato metoda odesílá LVM_GETGROUPRECT zprávy, která je popsána v .
Požadavky
Záhlaví: afxcmn.h
Tento ovládací prvek je podporována v a novější.
Další požadavky této metody jsou popsány v Vytváření požadavků pro běžné ovládací prvky systému Windows Vista.
Příklad
Následující příklad kódu definuje proměnné, m_listCtrl , je pro aktuální zobrazení seznamu řízení přístupu.Tato proměnná se používá v následujícím příkladu.
public:
// Variable used to access the list control.
CListCtrl m_listCtrl;
Následující příklad kódu ukazuje GetGroupRect metoda.V předchozí části tohoto příkladu kódu jsme vytvořili zobrazení seznamu ovládací prvek zobrazující dva sloupce v zobrazení sestavy s názvem "ClientID" a "Třídu".Například následující kód nakreslí 3D obdélník okolo skupiny, jejichž index je 0, pokud taková skupina existuje.
// 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);
}