LVM_GETSUBITEMRECT Nachricht

  • Artikel

Ruft Informationen zum umgebenden Rechteck für ein Unterelement in einem Listenansicht-Steuerelement ab. Sie können diese Nachricht explizit oder mithilfe des makros ListView_GetSubItemRect senden (empfohlen). Diese Nachricht soll nur mit Listenansichtssteuerelementen verwendet werden, die die LVS_REPORT-Format verwenden.

Parameter

wParam

Index des übergeordneten Elements des Unterelements.

lParam

Zeiger auf eine RECT-Struktur , die das Unterelement an das Rechteck gebundene Informationen empfängt. Seine Member müssen gemäß den folgenden Member-Wert-Beziehungen initialisiert werden:

Wert Bedeutung
top
 Der einbasierte Index des Unterelements.
left
 Flagwert (siehe Hinweise). Gibt den Teil des Listenansicht-Unterelements an, für den das umgebende Rechteck abgerufen werden soll.

Rückgabewert

Gibt bei erfolgreicher Ausführung nonzero zurück, oder andernfalls null.

Bemerkungen

Im Folgenden sind die Flagwerte aufgeführt, die festgelegt werden können.

Anforderung Wert
Flagwert Bedeutung
LVIR_BOUNDS Gibt das umgebende Rechteck des gesamten Elements zurück, einschließlich des Symbols und der Bezeichnung.
LVIR_ICON Gibt das umgebende Rechteck des Symbols oder des kleinen Symbols zurück.
LVIR_LABEL Gibt das umgebende Rechteck des gesamten Elements zurück, einschließlich des Symbols und der Bezeichnung. Dies ist identisch mit LVIR_BOUNDS.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2003 [nur Desktop-Apps]
Header
Commctrl.h