ListView_GetItemIndexRect Makro (commctrl.h)

2024-10-24

Ruft das umgebende Rechteck für alle oder einen Teil eines Unterelements in der aktuellen Ansicht eines angegebenen Listenansicht-Steuerelements ab. Verwenden Sie dieses Makro, oder senden Sie die LVM_GETITEMINDEXRECT Nachricht explizit.

Syntax

BOOL ListView_GetItemIndexRect(
  [in]      HWND        hwnd,
  [in]      LVITEMINDEX *plvii,
  [in]      LONG        iSubItem,
  [in]      LONG        code,
  [in, out] LPRECT      prc
);

Parameter

[in] hwnd

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

[in] plvii

Typ: LVITEMINDEX-*

Ein Zeiger auf eine LVITEMINDEX- Struktur für das übergeordnete Element des Unterelements. Der Aufrufer ist für die Zuordnung dieser Struktur und das Festlegen seiner Mitglieder verantwortlich. plvii darf nicht NULL-sein.

[in] iSubItem

Typ: LONG

Der Index des Unterelements.

[in] code

Typ: LONG

Der Teil des Listenansicht-Unterelements, für den das umgebende Rechteck abgerufen werden soll. Dieser Parameter muss einen der folgenden Werte aufweisen.

Wert	Bedeutung
LVIR_BOUNDS	Gibt das umgebende Rechteck des gesamten Unterelements zurück, einschließlich des Symbols und der Beschriftung.
LVIR_ICON	Gibt das umgebende Rechteck des Symbols oder des kleinen Symbols des Unterelements zurück.
LVIR_LABEL	Gibt das umgebende Rechteck des Unterelementtexts zurück.

[in, out] prc

Typ: LPRECT-

Ein Zeiger auf eine RECT- Struktur, um die Koordinaten zu empfangen. Der Aufrufer ist für die Zuordnung dieser Struktur verantwortlich. prc darf nicht NULLsein.

Rückgabewert

Typ: BOOL-

Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls.

Bemerkungen

Wenn iSubItem- null ist, gibt dieses Makro die Koordinaten des Rechtecks an das Element zurück, auf das plviiverweist. Der Wert LVIR_SELECTBOUNDS für den Parameter Code wird nicht unterstützt.

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

Freigeben über