The LV_ITEM structure specifies or receives the attributes of a list view item.
typedef struct _LV_ITEM { UINT mask; int iItem; int iSubItem; UINT state; UINT stateMask; LPTSTR pszText; int cchTextMax; int iImage; // index of the list view item’s icon LPARAM lParam; // 32-bit value to associate with item } LV_ITEM;
The following bit flags specify the members of the LV_ITEM structure that contain valid data or need to be filled in. One or more of these bit flags may be set:
Value |
Meaning |
LVIF_TEXT |
The pszText member is valid or needs to be filled in. |
LVIF_IMAGE |
The iImage member is valid or needs to be filled in. |
LVIF_PARAM |
The lParam member is valid or needs to be filled in. |
LVIF_STATE |
The state member is valid or needs to be filled in.. |
The following bit flag is used with the LVN_GETDISPINFO notification message:
Value |
Meaning |
LVIF_DI_SETITEM |
The operating system should store the requested list item information, and not ask for it again. |
The low-order byte contains a set of bit flags that indicate the item’s state. This byte can be a combination of the following values.
Value |
Meaning |
LVIS_CUT |
The item is marked for a cut and paste operation. |
LVIS_DROPHILITED |
The item is highlighted as a drag-and-drop target. |
LVIS_FOCUSED |
The item has the focus, so it is surrounded by a standard focus rectangle. Although more than one item may be selected, only one item can have the focus. |
LVIS_SELECTED |
The item is selected. The appearance of a selected item depends on whether it has the focus, and on the system colors used for selection. |
Bits 8 through 11 of the state member specify the one-based index of an overlay image in the control’s image lists. Both the full-sized icon image list and the small icon image list can have overlay images. The overlay image is superimposed over the item’s icon image. If these bits are zero, the item has no overlay image. To isolate these bits, use the LVIS_OVERLAYMASK mask.
Bits 12 through 15 of the state member specify the one-based index of an image in the control’s state image list. The state image is displayed next to an item’s icon to indicate an application-defined state. If these bits are zero, the item has no state image. To isolate these bits, use the LVIS_STATEIMAGEMASK mask.
If you are retrieving an item’s state, the state member receives the state of the bits indicated by the stateMask member.
If you are setting an item’s state, the stateMask member indicates the
bits of the state member to set.
If the structure is receiving item attributes, this member is the pointer to
the buffer that receives the item text.
If this member is the I_IMAGECALLBACK value, the parent window is responsible
for storing the index. In this case, the list view control sends the parent an
LVN_GETDISPINFO notification message to get
the index when it needs to display the image.
The LV_ITEM structure is used with a number of messages, including LVM_GETITEM, LVM_SETITEM, LVM_INSERTITEM, and LVM_DELETEITEM.
LVM_DELETEITEM, LVM_GETITEM, LVM_INSERTITEM, LVM_SETITEM
file: /Techref/os/win/api/win32/struc/src/str10_19.htm, 8KB, , updated: 2008/5/22 21:38, local time: 2024/8/25 05:05,
18.223.239.137:LOG IN
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://piclist.com/tecHREF/os/win/api/win32/struc/src/str10_19.htm"> LV_ITEM</A> |
Did you find what you needed? |
![]() o List host: MIT, Site host massmind.org, Top posters @none found - Page Editors: James Newton, David Cary, and YOU! * Roman Black of Black Robotics donates from sales of Linistep stepper controller kits. * Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters. * Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated! * Contributors: Richard Seriani, Sr. |
Welcome to piclist.com! |
.