Sets some or all of a list-view item's attributes. You can also send LVM_SETITEM to set the text of a subitem. You can send this message explicitly or by using the ListView_SetItem macro.
Syntax
To send this message, call the
SendMessage
function as follows.
|
lResult = SendMessage(
| // returns LRESULT in lResult
|
| (HWND) hWndControl,
| // handle to destination control
|
| (UINT) LVM_SETITEM,
| // message ID
|
| (WPARAM) wParam,
| // = 0; not used, must be zero |
| (LPARAM) lParam
| // = const (LPARAM) (LPLVITEM) pitem; |
|
);
| |
Parameters
- wParam
-
Must be zero.
- pitem
-
Pointer to an LVITEM structure that contains the new item attributes. The iItem and iSubItem members identify the item or subitem, and the
mask member specifies which attributes to set. If the mask member specifies the LVIF_TEXT value, the pszText member is the address of a null-terminated string and the cchTextMax member is ignored. If the mask member specifies the LVIF_STATE value, the stateMask member specifies which item states to change and the state member contains the values for those states.
Return Value
Returns TRUE if successful, or FALSE otherwise.
Remarks
To set the attributes of a list-view item, set the
iItem member of the LVITEM structure to the index of the item, and set the
iSubItem member to zero. For an item, you can set the state,
pszText,
iImage, and
lParam members of the LVITEM structure.
To set the text of a subitem, set the
iItem and
iSubItem members to indicate the specific subitem, and use the
pszText member to specify the text. Alternatively, you can use the ListView_SetItemText macro to set the text of a subitem. You cannot set the
state or
lParam members for subitems because subitems do not have these attributes. In version 4.70 and later, you can set the
iImage member for subitems. The subitem image will be displayed if the list-view control has the LVS_EX_SUBITEMIMAGES extended style. Previous versions will ignore the subitem image.
Message Information
| Header | commctrl.h |
|---|
| Minimum operating systems |
Windows NT 3.51, Windows 95 |
|---|