ListView_SetItem Makro (commctrl.h)

2024-10-24

Legt einige oder alle Attribute eines Listenansichtselements fest. Sie können auch ListView_SetItem verwenden, um den Text eines Unterelements festzulegen. Sie können dieses Makro verwenden oder die LVM_SETITEM Nachricht explizit senden.

Syntax

BOOL ListView_SetItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

Parameter

hwnd

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

pitem

Typ: const LPLVITEM

Ein Zeiger auf eine LVITEM- Struktur, die die neuen Elementattribute enthält. Die iItem- und iSubItem- Elemente identifizieren das Element oder Unterelement, und das Mask Element gibt an, welche Attribute festgelegt werden sollen. Wenn das Maskenelement Member den LVIF_TEXT-Wert angibt, wird das pszText-element die Adresse einer null-beendeten Zeichenfolge und das cchTextMax Member ignoriert. Wenn das mask Member den LVIF_STATE-Wert angibt, gibt das stateMask Member an, welche Elementzustände geändert werden sollen, und der Zustand Mitglied enthält die Werte für diese Zustände.

Rückgabewert

Typ: BOOL-

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

Bemerkungen

Um die Attribute eines Listenansichtselements festzulegen, legen Sie das iItem-element Member der LVITEM- Struktur auf den Index des Elements fest, und legen Sie den iSubItem- Member auf Null fest. Für ein Element können Sie den Zustand, pszText-, iImage-und lParam- Member der LVITEM- Struktur verwenden, um diese Elementparameter zu ändern.

Um den Text eines Unterelements festzulegen, legen Sie die iItem- und iSubItem- Member fest, um das bestimmte Unterelement anzugeben, und verwenden Sie das pszText Member, um den Text anzugeben. Alternativ können Sie das ListView_SetItemText Makro verwenden, um den Text eines Unterelements festzulegen. Sie können den Zustand nicht oder lParam- Member für Unterelemente festlegen, da Unterelemente diese Attribute nicht aufweisen. In Version 4.70 und höher können Sie das iImage Member für Unterelemente festlegen. Das Unterelementbild wird angezeigt, wenn das Listenansicht-Steuerelement über die LVS_EX_SUBITEMIMAGES erweiterte Formatvorlage verfügt. In früheren Versionen wird das Unterelementbild ignoriert.

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

Freigeben über