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 |
|
| Unicode- und ANSI-Name |
LVM _ GETITEMW (Unicode) und LVM _ GETITEMA (ANSI) |