Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ruft Informationen über eine bestimmte Gruppe im aktuellen Listenansicht-Steuerelement ab.
BOOL GetGroupInfoByIndex(
int iIndex,
PLVGROUP pGroup
) const;
Parameter
Parameter |
Description |
|---|---|
[in] iIndex |
Der nullbasierte Index einer Gruppe. |
[out] pGroup |
Zeiger auf eine LVGROUP-Struktur, die Informationen über die Gruppe erhält, wurden vom iIndex-Parameter an. Der Aufrufer ist für das Initialisieren der Member der Struktur LVGROUP zuständig.Legen Sie den cbSize-Member zur Größe der Struktur und die Flags für mask-Members fest, um die Informationen anzugeben, um abzurufen. |
Rückgabewert
true, wenn diese Methode erfolgreich ist; andernfalls false.
Hinweise
Diese Methode sendet die LVM_GETGROUPINFOBYINDEX Meldung, die im Windows SDK beschrieben wird.
Anforderungen
Header: afxcmn.h
Dieses Steuerelement wird in Windows Vista und höher unterstützt.
Zusätzliche Anforderungen für diese Methode werden in Build-Anforderungen für Windows Vista-gemeinsame Regelungen beschrieben.
Beispiel
Im folgenden Codebeispiel wird eine Variable, m_listCtrl, die verwendet wird, um auf das aktuelle Listenansicht-Steuerelement zuzugreifen.Diese Variable wird im folgenden Beispiel verwendet.
public:
// Variable used to access the list control.
CListCtrl m_listCtrl;
Im folgenden Codebeispiel wird die GetGroupInfoByIndex-Methode veranschaulicht.In einem früheren Abschnitt dieses Codebeispiels erstellt haben wir ein ListView-Steuerelement, das Anzeigen zwei Spalten "ClientID" und "Grad" in einer Berichtsansicht Titel.Im folgenden Codebeispiel ruft Informationen über die Gruppe ab, deren Index 0, wenn eine Gruppe vorhanden ist.
// 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."));
}