LVM_SETITEM Nachricht

Legt einige oder alle Attribute eines Listenansichtelements fest. Sie können auch LVM_SETITEM senden, um den Text eines Unterelements festzulegen. Sie können diese Nachricht explizit oder mithilfe des makros ListView_SetItem senden.

Parameter

wParam

Muss Null sein.

lParam

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

Rückgabewert

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

Bemerkungen

Um die Attribute eines Listenansichtselements festzulegen, legen Sie das iItem-Element der LVITEM-Struktur auf den Index des Elements fest, und legen Sie das iSubItem-Element auf 0 fest. Für ein Element können Sie die Status-, pszText-, iImage- und lParam-Member der LVITEM-Struktur festlegen.

Um den Text eines Unterelements festzulegen, legen Sie die Elemente iItem und iSubItem so fest, dass sie das spezifische Unterelement angeben, und verwenden Sie das pszText-Element , um den Text anzugeben. Alternativ können Sie das makro ListView_SetItemText verwenden, um den Text eines Unterelements festzulegen. Sie können die Status - oder lParam-Member für Unterelemente nicht festlegen, da Unterelemente diese Attribute nicht aufweisen. Ab Version 4.70 können Sie das Element iImage für Unterelemente festlegen. Das Unterelementbild wird angezeigt, wenn das Listenansichtssteuerelement die LVS_EX_SUBITEMIMAGES erweiterten Format aufweist. In früheren Versionen wird das Unterelementimage ignoriert.

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_SETITEMW (Unicode) und LVM_SETITEMA (ANSI)