ListView_SetGroupState Makro (commctrl.h)

  • Artikel

Legt den Status für eine angegebene Gruppe fest.

Syntax

LRESULT ListView_SetGroupState(
  [in] HWND hwnd,
  [in] UINT dwGroupId,
  [in] UINT dwMask,
  [in] UINT dwState
);

Parameter

[in] hwnd

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

[in] dwGroupId

Typ: UINT-

Gibt die Gruppe nach iGroupId- an (siehe LVGROUP--Struktur).

[in] dwMask

Typ: UINT-

Gibt die Zustandswerte an, die festgelegt oder gelöscht werden sollen. Dies ist eine Kombination der Flags, die für den Zustand Mitglied von LVGROUP-aufgeführt sind.

[in] dwState

Typ: UINT-

Gibt die festzulegenden Zustandswerte an. Staaten, die hier nicht enthalten sind, aber in dwMask enthalten sind, werden gelöscht.

Rückgabewert

Typ: LRESULT-

Gibt die ID der Gruppe (iGroupId) zurück, falls erfolgreich, oder -1 andernfalls.

Bemerkungen

Hinweis Um dieses Makro zu verwenden, müssen Sie ein Manifest angeben, das Comctl32.dll Version 6.0 angibt. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.
 
Sie können den Gruppenstatus auch mithilfe von ListView_SetGroupInfofestlegen.

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