ListView_SetItem

  • 项目

This macro sets some or all of a list-view item's attributes. You can also use ListView_SetItem to set the text of a subitem. You can use this macro or send the LVM_SETITEM message explicitly.

BOOL ListView_SetItem( 
  HWND hwnd, 
  const LVITEM FAR* pitem 
);

Parameters

  • hwnd
    Handle to the list-view control.

  • 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 Values

TRUE indicates success. FALSE indicates failure.

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 use the state, pszText, iImage, and lParam members of the LVITEM structure to modify these item parameters.

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. 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.

Related message:LVM_SETITEM

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Commctrl.h.

See Also

LVM_SETITEM | List-View Controls Macros

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.