ListView_GetItem Makro (commctrl.h)

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

Syntax

BOOL ListView_GetItem(
   HWND     hwnd,
   LPLVITEM pitem
);

Parameter

hwnd

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

pitem

Typ: LPLVITEM-

Ein Zeiger auf eine LVITEM- Struktur, die die abzurufenden Informationen angibt und Informationen zum Listenansichtselement empfängt.

Rückgabewert

Typ: BOOL-

Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls.

Bemerkungen

Wenn die LVM_GETITEM Nachricht gesendet wird, geben die iItem- und iSubItem- Elemente das Element oder Unterelement an, um Informationen abzurufen, und das Mask Element 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 Mask Element der LVITEM--Struktur festgelegt ist, muss das pszText-Element auf einen gültigen Puffer zeigen, und das cchTextMax Member muss auf die Anzahl der Zeichen in diesem Puffer festgelegt werden. Anwendungen sollten nicht davon ausgehen, dass der Text unbedingt im angegebenen Puffer platziert wird. Das Steuerelement kann stattdessen das pszText Element der Struktur ändern, um auf den neuen Text zu zeigen, anstatt es in den Puffer zu setzen.

Wenn das Mask Element den LVIF_STATE-Wert angibt, muss das stateMask Member die abzurufenden Elementstatusbits angeben. Bei der Ausgabe enthält der Zustand Member die Werte der angegebenen Statusbits.

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