CListCtrl::GetGroupRect
Pobiera prostokąta obwiedni dla określonej grupy bieżącego formantu widoku listy.
BOOL GetGroupRect(
int iGroupId,
LPRECT lpRect,
int iCoords = LVGGR_GROUP
) const;
Parametry
Parametr |
Opis |
|---|---|
[w]iGroupId |
Określa grupę. |
[out]lpRect |
Wskaźnik RECT struktury.Jeśli ta metoda jest pomyślne, struktura odbiera współrzędne prostokąta grupy określonej przez iGroupId. |
[w]iCoords |
Określa współrzędne prostokąt, aby pobrać.Użyj jednego z następujących wartości:
|
Wartość zwracana
trueJeśli ta metoda jest pomyślne; w przeciwnym razie false.
Uwagi
Obiekt wywołujący jest odpowiedzialny za przydzielanie RECT struktury wskazywanej przez pRect parametru.
Metoda ta wysyła LVM_GETGROUPRECT wiadomości, która jest opisana w Windows SDK.
Wymagania
Nagłówek: afxcmn.h
Ten formant jest obsługiwany w Windows Vista i później.
Dodatkowe wymagania dla tej metody opisane w Budowanie wymagania dla systemu Windows Vista wspólnej kontroli.
Przykład
Poniższy przykład kodu definiuje zmienną, m_listCtrl, czyli używane do bieżącego widoku listy kontroli dostępu.Ta zmienna jest używana w następnym przykładzie.
public:
// Variable used to access the list control.
CListCtrl m_listCtrl;
Poniższy przykład kodu pokazuje GetGroupRect metody.We wcześniejszej sekcji tego przykładu kodu stworzyliśmy formantu widoku listy, który wyświetla dwie kolumny zatytułowanej "ClientID" i "Klasa" w widoku raportu.Poniższy kod rysuje 3D prostokąt wokół grupy, której indeks wynosi 0, jeśli istnieje taka grupa.
// 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);
}