CListCtrl::GetGroupInfoByIndex
Pobiera informacje o określonej grupy bieżącego formantu widoku listy.
BOOL GetGroupInfoByIndex(
int iIndex,
PLVGROUP pGroup
) const;
Parametry
Parametr |
Opis |
|---|---|
[w]iIndex |
Indeks grupy od zera. |
[out]pGroup |
Wskaźnik do LVGROUP strukturę, która otrzymuje informacje o grupie określonej przez iIndex parametru. Obiekt wywołujący jest odpowiedzialny za inicjowanie członków LVGROUP struktury.Ustaw cbSize Członkowskich rozmiar struktury i flag mask Członkowskich do określenia informacji do pobrania. |
Wartość zwracana
trueJeśli ta metoda jest pomyślne; w przeciwnym razie false.
Uwagi
Metoda ta wysyła LVM_GETGROUPINFOBYINDEX 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 GetGroupInfoByIndex metody.W wcześniejszej części tego kodu przykładu, że utworzyliśmy formantu widoku listy wyświetla dwie kolumny zatytułowanej "ClientID" i "Klasa" w widoku raportu.Poniższy kod pobiera informacje o grupie, której indeks wynosi 0, jeśli istnieje taka grupa.
// GetGroupInfoByIndex
const int GROUP_HEADER_BUFFER_SIZE = 40;
// Initialize the structure
LVGROUP gInfo = {0};
gInfo.cbSize = sizeof(LVGROUP);
wchar_t wstrHeadGet[GROUP_HEADER_BUFFER_SIZE] = {0};
gInfo.cchHeader = GROUP_HEADER_BUFFER_SIZE;
gInfo.pszHeader = wstrHeadGet;
gInfo.mask = (LVGF_ALIGN | LVGF_STATE | LVGF_HEADER | LVGF_GROUPID);
gInfo.state = LVGS_NORMAL;
gInfo.uAlign = LVGA_HEADER_LEFT;
BOOL bRet = m_listCtrl.GetGroupInfoByIndex( 0, &gInfo );
if (bRet == TRUE) {
CString strHeader = CString( gInfo.pszHeader );
CString str;
str.Format(_T("Header: '%s'"), strHeader);
AfxMessageBox(str, MB_ICONINFORMATION);
}
else
{
AfxMessageBox(_T("No group information was retrieved."));
}