ListView_GetGroupRect Makro (commctrl.h)

  • Artikel

Ruft das Rechteck für eine angegebene Gruppe ab. Verwenden Sie dieses Makro, oder senden Sie die LVM_GETGROUPRECT Nachricht explizit.

Syntax

void ListView_GetGroupRect(
  [in]       hwnd,
  [in]       iGroupId,
  [in]       type,
  [in, out]  prc
);

Parameter

[in] hwnd

Typ: HWND

Ein Handle für das Listenansichtssteuerelement.

[in] iGroupId

Typ: int

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

[in] type

Typ: LONG

Gibt den Typ des abzurufenden Rechtecks an. Dieser Parameter muss einen der folgenden Werte aufweisen.

Wert Bedeutung
LVGGR_GROUP
 Koordinaten der gesamten erweiterten Gruppe.
LVGGR_HEADER
 Koordinaten nur des Headers (reduzierte Gruppe).
LVGGR_LABEL
 Nur Koordinaten der Bezeichnung.
LVGGR_SUBSETLINK
 Nur Koordinaten des Teilmengenlinks (Markupteilmenge). Ein Listenansichtssteuerelement kann die Anzahl der sichtbaren Elemente begrenzen, die in jeder Gruppe angezeigt werden. Dem Benutzer wird ein Link angezeigt, damit der Benutzer die Gruppe erweitern kann. Dieses Flag gibt das umgebende Rechteck des Teilmengenlinks zurück, wenn es sich bei der Gruppe um eine Teilmenge handelt (Gruppenstatus von LVGS_SUBSETED, siehe Struktur LVGROUP, Mitgliedsstatus). Dieses Flag wird bereitgestellt, damit Barrierefreiheitsanwendungen den Link finden können.

[in, out] prc

Typ: RECT*

Ein Zeiger auf eine RECT-Struktur zum Empfangen von Informationen zu der von iGroupId angegebenen Gruppe. Der Nachrichtenempfänger ist dafür verantwortlich, die Strukturmitglieder mit Informationen für die von iGroupId angegebene Gruppe festzulegen. Die aufrufende Anwendung ist für die Zuweisung von Arbeitsspeicher für die Struktur verantwortlich.

Rückgabewert

Keine

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile commctrl.h