|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| -
| Header File
| commctrl.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
LV_ITEM
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;
Members
mask
A set of bit flags that specify attributes of this data structure or of an
operation that is using this structure.
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.
|
iItem
Specifies the zero-based index of the item to which this structure refers.
iSubItem
Specifies the one-based index of the subitem to which this structure refers,
or zero if this structure refers to an item rather than a subitem.
state
Specifies the current state of the item if the item's state is being
retrieved, or the new state if the item's state is being set. The stateMask member specifies the bits of the state member that are valid. This member can be any valid combination of state
values. For a list of item states, see List View Item States.
stateMask
Specifies the bits of the state member that are valid.
pszText
Pointer to a null-terminated string that contains the item text if the
structure specifies item attributes. If this member is the LPSTR_TEXTCALLBACK value,
the item is a callback item. Do not set the pszText member to LPSTR_TEXTCALLBACK if the list view control has LVS_SORTASCENDING
or LVS_SORTDESCENDING style.
If the structure is receiving item attributes, this member is the pointer to
the buffer that receives the item text.
cchTextMax
Size of the buffer pointed to by the pszText member if the structure is receiving item attributes. If the structure
specifies item attributes, this member is ignored.
iImage
Index of the list view item's icon in the icon and small icon image lists.
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.
lParam
A 32-bit value to associate with the item. If you use the LVM_SORTITEMS message, the list view control passes this value to the application-defined
comparison function. You can also use the LVM_FINDITEM message to search a list view control for an item with a specified lParam value.
Remarks
The LV_ITEM structure is used with a number of messages, including LVM_GETITEM,
LVM_SETITEM, LVM_INSERTITEM, and LVM_DELETEITEM.
See Also
LVM_DELETEITEM, LVM_GETITEM, LVM_INSERTITEM, LVM_SETITEM
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
