LVM _ SETITEM-Nachricht

Legt einige oder alle Attribute eines Listenansichtselements fest. Sie können LVM _ SETITEM auch senden, um den Text eines Unteritems zu festlegen. Sie können diese Nachricht explizit oder mithilfe des ListView _ SetItem-Makros senden.

Parameter

wParam

Muss Null sein.

lParam

Zeiger auf eine LVITEM-Struktur, die die neuen Elementattribute enthält. Die Member iItem und iSubItem identifizieren das Element oder Unterelement, und das Maskenelement gibt an, welche Attribute festgelegt werden. Wenn das Maskenmitglied den LVIF TEXT-Wert angibt, ist der pszText-Member die Adresse einer auf NULL terminierten Zeichenfolge, und das _ cchTextMax-Element wird ignoriert. Wenn das Maskenelement den LVIF STATE-Wert angibt, gibt das _ stateMask-Element 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 erfolgreich, andernfalls FALSE.

Hinweise

Legen Sie zum Festlegen der Attribute eines Listenansichtselements das iItem-Element der LVITEM-Struktur auf den Index des Elements und das iSubItem-Element auf 0 (null) fest. Für ein Element können Sie die Member , pszText, iImage und lParam der LVITEM-Struktur festlegen.

Legen Sie zum Festlegen des Texts eines Unterems die Member iItem und iSubItem fest, um das spezifische Unterem anzugeben, und verwenden Sie das pszText-Member, um den Text anzugeben. Alternativ können Sie das ListView _ SetItemText-Makro verwenden, um den Text eines Unteremems zu festlegen. Sie können den Status oder die lParam-Member für Unteritems nicht festlegen, da Unteritems diese Attribute nicht haben. In Version 4.70 und höher können Sie das iImage-Mitglied für Unteritems festlegen. Das Untersteuerbild wird angezeigt, wenn das Listenansicht-Steuerelement den erweiterten Stil LVS _ EX _ SUBITEMIMAGES auflistet. Frühere Versionen ignorieren das Unteritemimage.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Commctrl.h
Unicode- und ANSI-Name
LVM _ SETITEMW (Unicode) und LVM _ SETITEMA (ANSI)