LVM _ GETITEM-Nachricht

Ruft einige oder alle Attribute eines Listenansichtselements ab. Sie können diese Nachricht explizit oder mithilfe des ListView _ GetItem-Makros senden.

Parameter

wParam

Muss Null sein.

lParam

Zeiger auf eine LVITEM-Struktur, die die abzurufenden Informationen angibt und Informationen über das Listenansichtselement empfängt.

Rückgabewert

Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE.

Hinweise

Wenn die LVM _ GETITEM-Nachricht gesendet wird, identifizieren die Elemente iItem und iSubItem das Element oder Unterelement, zu dem Informationen abgerufen werden sollen, und der Maskenmember gibt an, welche Attribute abgerufen werden sollen. Eine Liste der möglichen Werte finden Sie in der Beschreibung der LVITEM-Struktur.

Wenn das LVIF _ TEXT-Flag im Maskenmember der LVITEM-Struktur festgelegt ist, muss der pszText-Member auf einen gültigen Puffer zeigen, und das cchTextMax-Element muss auf die Anzahl der Zeichen in diesem Puffer festgelegt werden. Anwendungen sollten nicht davon ausgehen, dass der Text notwendigerweise im angegebenen Puffer platziert wird. Das Steuerelement kann stattdessen den pszText-Member der -Struktur so ändern, dass er auf den neuen Text verweist, anstatt ihn im Puffer zu platzieren.

Wenn der Maskenmember den LVIF _ STATE-Wert angibt, muss der stateMask-Member die abzurufenden Elementzustandsbits angeben. Bei der Ausgabe enthält der Zustandsmember die Werte der angegebenen Zustandsbits.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Commctrl.h
Unicode- und ANSI-Name
LVM _ GETITEMW (Unicode) und LVM _ GETITEMA (ANSI)