Freigeben über


ListView_GetGroupInfoByIndex Makro (commctrl.h)

Ruft Informationen zu einer angegebenen Gruppe ab. Verwenden Sie dieses Makro, oder senden Sie die LVM_GETGROUPINFOBYINDEX Nachricht explizit.

Syntax

LRESULT ListView_GetGroupInfoByIndex(
  [in]      HWND     hwnd,
  [in]      int      iIndex,
  [in, out] PLVGROUP pgrp
);

Parameter

[in] hwnd

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

[in] iIndex

Typ: int

Der Index der Gruppe.

[in, out] pgrp

Typ: PLVGROUP-

Ein Zeiger auf eine LVGROUP- Struktur, um Informationen zu der gruppe zu empfangen, die durch iIndex-angegeben wird. Die aufrufende Anwendung ist für das Zuordnen des Speichers für die Struktur und alle Puffer in der Struktur verantwortlich, z. B. das von pszHeaderverweist. Legen Sie alle kontingenten Elemente der Struktur fest, z. B. cchHeader-– die Größe des Puffers, auf den pszHeader in WCHARverweist, einschließlich der endierenden NULL-. Legen Sie cbSize- auf die Größe LVGROUP- in Byte fest.

Der Nachrichtenempfänger ist für das Festlegen der Strukturmitglieder mit Informationen für die gruppe verantwortlich, die von iIndex-angegeben wird.

Rückgabewert

Typ: LRESULT-

Gibt 1 zurück, wenn dies erfolgreich ist, oder 0 andernfalls.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2008 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- commctrl.h