ListView_GetSubItemRect Makro (commctrl.h)

  • Artikel

Ruft Informationen zum Rechteck ab, das ein Unterelement in ein Listenansicht-Steuerelement umgibt. Sie können dieses Makro (empfohlen) verwenden oder die LVM_GETSUBITEMRECT Nachricht explizit senden. Dieses Makro soll nur für Listenansichtssteuerelemente verwendet werden, die die LVS_REPORT Formatvorlage verwenden.

Syntax

BOOL ListView_GetSubItemRect(
   HWND   hwnd,
   int    iItem,
   int    iSubItem,
   int    code,
   LPRECT prc
);

Parameter

hwnd

Typ: HWND-

Ein Handle zu einem Listenansichtssteuerelement.

iItem

Typ: int

Der Index des übergeordneten Elements des Unterelements.

iSubItem

Typ: int

Der 1-basierte Index des Unterelements.

code

Typ: int

Ein Teil des Listenansicht-Unterelements, für den die umgebenden Rechteckinformationen abgerufen werden sollen. Dieser Wert kann eine der folgenden Sein:

Wert Bedeutung
LVIR_BOUNDS
 Gibt das umgebende Rechteck des gesamten Elements zurück, einschließlich des Symbols und der Beschriftung.
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 Beschriftung. Dies ist identisch mit LVIR_BOUNDS.

prc

Typ: LPRECT-

Zeiger auf eine RECT- Struktur, die die Unterelement-umgebenden Rechteckinformationen empfängt.

Rückgabewert

Typ: BOOL-

Gibt "nonzero" zurück, wenn dies erfolgreich ist, oder 0 andernfalls null.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- commctrl.h