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 |
|
| Unicode- und ANSI-Name |
LVM _ SETITEMW (Unicode) und LVM _ SETITEMA (ANSI) |