На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

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


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

LV_ITEM



Структура LV_ITEM определяет или получает атрибуты пункта вида списка.

typedef struct _LV_ITEM { маска UINT;
int iItem;
int iSubItem;
СОСТОЯНИЕ UINT;
UINT stateMask;
LPTSTR pszText;
int cchTextMax;
int iImage; // индекс иконы пункта вида списка LPARAM lParam; // 32- битовая величина, чтобы соединяться с пунктом } LV_ITEM;


Участники

маска

Установка бита сигнализирует, что определяет атрибуты этой структуры данных или операции, которая использует эту структуру.
Битовые флаги следующего определяют участников структуры LV_ITEM, которая содержит правильные данные или должно быть заполнено. Одно или более этих кусают флаги может быть установлено:

Значение Величины
LVIF_TEXT элемент pszText - в силе или должно быть заполнено.
LVIF_IMAGE элемент iImage - в силе или должно быть заполнено.
LVIF_PARAM элемент lParam - в силе или должно быть заполнено.
LVIF_STATE государственный элемент - в силе или должно быть заполнено..


Битовый флаг следующего использован сообщением уведомления LVN_GETDISPINFO:

Значение Величины
LVIF_DI_SETITEM операционная система должна загружать информацию пункта запрошенного списка, и не требовать это снова.


iItem

Определяет базирующийся нулевой индекс пункта на котором эта структура отмечается.

iSubItem

Определяет один-основавшее индекс подэлемента на котором эта структура отмечает, или нуль если эта структура имеет отношение к пункту а не подэлемент.

состояние

Определяет текущее состояние пункта если состояние пункта извлекается, или новое состояние если состояние пункта установленн. Элемент stateMask определяет биты штата элемента, который в силе. Этот элемент может быть любой правильной комбинацией государственных величин. Для списка состояний пункта, видьте как Список Рассматривал Состояния Пункта.

stateMask

Определяет биты штата элемента, который в силе.

pszText

Указатель в недействительный расторгнутую строку, которая содержит текст пункта если структура определяет атрибуты пункта. Если этот элемент является величиной LPSTR_TEXTCALLBACK, пункт является пунктом возврата. Не Сделайте устанавливать элемент pszText на LPSTR_TEXTCALLBACK если управление вида списка имеет LVS_SORTASCENDING или стиль LVS_SORTDESCENDING.
Если структура получает атрибуты пункта, этот элемент является указателем в буфер, который получает текст пункта.

cchTextMax

Размер буфера указывался, чтобы элементом pszText если структура получает атрибуты пункта. Если структура определяет атрибуты пункта, этот элемент проигнорирован.

iImage

Проиндексируйте иконку пункта вида списка в иконных и небольших иконных списках образа.
Если этот элемент является величиной I_IMAGECALLBACK, родительское окно ответственное за хранение индекса. В этом случае, управление вида списка посылает родителю сообщение уведомления LVN_GETDISPINFO, чтобы получать индекс когда ему нужно отображать образ.

lParam

32- Битовая величина, чтобы соединяться с пунктом. Если Вы используете сообщение LVM_SORTITEMS, управление вида списка передает эту величину в определенную прикладную функцию сравнения. Вы можете также использовать сообщение LVM_FINDITEM, чтобы искать управление вида списка для пункта с определенной величиной lParam.



Замечания

Структура LV_ITEM использована множеством сообщений, включая LVM_GETITEM, LVM_SETITEM, LVM_INSERTITEM, и LVM_DELETEITEM.

Смотри Также

LVM_DELETEITEM, LVM_GETITEM, LVM_INSERTITEM, LVM_SETITEM


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz