ListView_GetItem Makro (commctrl.h)

Ruft einige oder alle Attribute eines Listenansichtelements ab. Sie können dieses Makro verwenden oder die LVM_GETITEM Nachricht explizit senden.

Syntax

void ListView_GetItem(
   hwnd,
   pitem
);

Parameter

hwnd

Typ: HWND

Ein Handle für das Listenansichtssteuerelement.

pitem

Typ: LPLVITEM

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

Rückgabewert

Keine

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

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commctrl.h