LVM_GETITEM Nachricht

Ruft einige oder alle Attribute eines Listenansichtelements ab. Sie können diese Nachricht explizit oder mithilfe des Makros ListView_GetItem senden.

Parameter

wParam

Muss Null sein.

lParam

Zeiger auf eine LVITEM-Struktur , die die Informationen zum Abrufen und Empfangen von Informationen zum Listenansichtselement angibt.

Rückgabewert

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE .

Bemerkungen

Wenn die LVM_GETITEM Nachricht gesendet wird, identifizieren die Elemente iItem und iSubItem das Element oder Unterelement, über das Informationen abgerufen werden sollen, und das Maskenelement 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 das pszText-Element 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 das Maskenelement den LVIF_STATE Wert angibt, muss der stateMask-Member die abzurufenden Elementstatusbits angeben. Bei der Ausgabe enthält der Zustandsmember die Werte der angegebenen Zustandsbits.

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
Unicode- und ANSI-Name
LVM_GETITEMW (Unicode) und LVM_GETITEMA (ANSI)