CListCtrl::GetGroupInfoByIndex
Načte informace o určené skupiny v aktuální ovládací prvek seznamu zobrazení.
BOOL GetGroupInfoByIndex(
int iIndex,
PLVGROUP pGroup
) const;
Parametry
Parametr |
Description |
|---|---|
[v]iIndex |
Z nuly vycházející index skupiny. |
[výstup]pGroup |
Ukazatel LVGROUP struktury, která obdrží informace o skupině určené iIndex parametr. Volající je zodpovědný za inicializaci členů LVGROUP struktury.Nastavit cbSize velikost struktury a vlajkami členských mask člen zadat informace, které chcete načíst. |
Vrácená hodnota
truePokud je tato metoda úspěšná. jinak false .
Poznámky
Tato metoda odesílá LVM_GETGROUPINFOBYINDEX 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 Požadavky na sestavení 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 GetGroupInfoByIndex metoda.V předchozí části tohoto kódu příkladu jsme vytvořili ovládací prvek zobrazení seznamu, zobrazí dva sloupce v zobrazení sestavy s názvem "ClientID" a "Třídu".Následující příklad kódu načte informace o skupině, jejíž index je 0, pokud taková skupina existuje.
// 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."));
}