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

BOOL ListView_GetGroupRect(
  [in]      HWND hwnd,
  [in]      int  iGroupId,
  [in]      LONG type,
  [in, out] RECT *prc
);

Parameter

[in] hwnd

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

[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
 Nur Koordinaten der Kopfzeile (reduzierte Gruppe).
LVGGR_LABEL
 Nur Koordinaten der Beschriftung.
LVGGR_SUBSETLINK
 Koordinaten der Teilmenge nur (Markupteilmenge). Ein Listenansichtssteuerelement kann die Anzahl der sichtbaren Elemente einschränken, die in jeder Gruppe angezeigt werden. Dem Benutzer wird ein Link angezeigt, über den der Benutzer die Gruppe erweitern kann. Dieses Flag gibt das umgebende Rechteck der Teilmenge-Verknüpfung zurück, wenn es sich bei der Gruppe um eine Teilmenge handelt (Gruppenstatus von LVGS_SUBSETED, siehe Struktur LVGROUP-, Mitglied Zustand). Dieses Kennzeichen wird bereitgestellt, sodass Barrierefreiheitsanwendungen den Link finden können.

[in, out] prc

Typ: RECT-*

Ein Zeiger auf eine RECT- Struktur, um Informationen zu der gruppe zu empfangen, die durch iGroupId-angegeben wird. Der Nachrichtenempfänger ist für das Festlegen der Strukturmitglieder mit Informationen für die gruppe verantwortlich, die durch iGroupId-angegeben wird. Die aufrufende Anwendung ist für die Zuordnung des Speichers für die Struktur verantwortlich.

Rückgabewert

Typ: BOOL-

Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE 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