Коды извещений
Код извещения передается через поле code структуры NMHDR . Напомним, что адрес этой структуры находится в параметре lParam сообщения WM_NOTIFY.
Родительское окно может получить следующие коды извещений:
| Код извещения | Описание |
| LVN_BEGINDRAG | Начало операции переноса "drag and drop" |
| LVN_BEGINLABELEDIT | Начало операции редактирования названия элемента |
| LVN_BEGINRDRAG | Начало операции переноса "drag and drop" с использованием правой клавиши мыши |
| LVN_COLUMNCLICK | Пользователь сделал щелчок мышью по заголовку столбца в режиме детального отчета |
| LVN_DELETEALLITEMS | Удаление всех элементов списка |
| LVN_DELETEITEM | Удаление определенного элемента списка |
| LVN_ENDLABELEDIT | Завершение операции редактирования названия элемента |
| LVN_GETDISPINFO | Орган управления запрашивает информацию, необходимую для отображения элемента. Это извещение приходит, в частности, когда при добавлении элемента вместо адреса реальной текстовой строки была указана константа LPSTR_TEXTCALLBACK |
| LVN_INSERTITEM | Вставка в список нового элемента |
| LVN_ITEMCHANGED | Произошло изменение элемента |
| LVN_ITEMCHANGING | С помощью этого извещения родительскому окну предоставляется возможность отменить предполагаемое изменение элемента |
| LVN_KEYDOWN | Была нажата клавиша |
| LVN_SETDISPINFO | Родительское окно должно обновить информацию об элементах списка, которую оно хранит в своих структурах данных |
Рассмотрим особенности обработки некоторых извещений на примере нашего приложения List Application. Подробную информацию об остальных извещениях вы сможете найти в справочной системе SDK.
LVN_GETDISPINFO
Так как при добавлении элементов в поле pszText была записана константа LPSTR_TEXTCALLBACK, для отображения списка орган управления List View "попросит" родительское окно предоставить ему адрес реальной текстовой строки. В результате родительское окно получит извещение с кодом LVN_GETDISPINFO.
Вместе с этим извещением в параметре lParam передается указатель на структуру LV_DISPINFO , которая будет использоваться для передачи информации:
typedef struct tagLV_DISPINFO { NMHDR hdr; // для любого сообщения WM_NOTIFY LV_ITEM item; // информация об элементе списка } LV_DISPINFO;
Структура LV_ITEM была описана выше в разделе "Вставка элементов списка".
При получении извещения LVN_GETDISPINFO родительское окно должно проверить содержимое поля mask структуры item. Маски в этом поле определяют, какая информация должна быть предоставлена при обработке извещения. Возможны следующие значения:
| Значение | Запрашиваемая информация |
| LVIF_IMAGE | Необходимо заполнить в структуре item поле iImage (номер изображения в списке изображений) |
| LVIF_STATE | Поле state (состояние элемента списка) |
| LVIF_TEXT | В поле pszText необходимо записать адрес буфера, содержащего строку текста |
LV_DISPINFO * lpLvdi = (LV_DISPINFO *)pnmhdr; APPLINFO * lpAppinfo = (APPLINFO *)(lpLvdi->item.lParam); static char szBuf[20]; ... case LVN_GETDISPINFO: { if(lpLvdi->item.mask & LVIF_TEXT) { switch(lpLvdi->item.iSubItem) { case 0: lpLvdi->item.pszText = lpAppinfo->szAppName; break; case 1: lpLvdi->item.pszText = lpAppinfo->szIconName; break; case 2: itoa(lpAppinfo->iCost, szBuf, 10); lpLvdi->item.pszText = szBuf; break; default: break; } break; } }
Если в поле mask установлен флаг LVIF_TEXT , обработчик извещения анализирует поле iSubItem структуры item.
В том случае, когда содержимое этого поля равно 0, требуется получить текстовую строку названия элемента списка. Адрес этой строки определяется с помощью поля lParam структуры item (соответствующее значение было записано в это поле при добавлении элементов к списку макрокомандой ListView_InsertItem ).
Аналогично обрабатывается извещение для первого дополнительного элемента. Второй дополнительный элемент содержит не текстовое, а числовое значение. Поэтому нам приходится выполнять преобразование при помощи функции itoa.
LVN_COLUMNCLICK
Проверяя работу органа управления List View, вы сможете убедиться в том что с его помощью можно легко выполнить сортировку элементов списка по имени или по содержимому дополнительных элементов. Для этого вам достаточно лишь сделать щелчок мышью по заголовку нужного столбца.
Можно было бы подумать, что орган управления List View выполняет сортировку сам, без дополнительных усилий со стороны программиста, однако это не так. Очевидно, функции окна List View не известно, какой именно алгоритм сортировки должен быть использован в вашем приложении.
Тем не менее вы без особого труда сможете организовать простейшую сортировку текстовых и числовых полей. Для этого вам нужно создать обработчик извещения LVN_COLUMNCLICK и написать свою функцию сравнения двух элементов.
Обработчик извещения LVN_COLUMNCLICK может выглядеть, например, так:
NM_LISTVIEW *lpNm = (NM_LISTVIEW *)pnmhdr; ... case LVN_COLUMNCLICK: { ListView_SortItems(lpNm->hdr.hwndFrom, LVCompareProc, (LPARAM)(lpNm->iSubItem)); return 0L; break; }
Обработка извещения LVN_COLUMNCLICK сводится к вызову единственной макрокоманды ListView_SortItems, посылающей окну органа управления List View сообщение LVM_SORTITEMS :
BOOL ListView_SortItems( HWND hwnd, // идентификатор окна органа List View PFNLVCOMPARE pfnCompare, // указатель на функцию сравнения LPARAM lParamSort); // произвольное значение, которое // передается функции сравнения
В качестве последнего параметра мы передаем макрокоманде номер дополнительного элемента, по которому выполняется сортировка.
При вызове обработчика извещения LVN_COLUMNCLICK в параметре lParam сообщения WM_NOTIFY передается адрес структуры NM_LISTVIEW , определенной следующим образом:
typedef struct tagNM_LISTVIEW { NMHDR hdr; // для любого сообщения WM_NOTIFY int iItem; // номер элемента списка int iSubItem; // номер дополнительного элемента списка UINT uNewState; // новое состояние элемента UINT uOldState; // старое состояние элемента UINT uChanged; // изменившиеся атрибуты элемента POINT ptAction; // позиция, в котором произошло событие LPARAM lParam; // дополнительное значение } NM_LISTVIEW;
Наш обработчик извещения LVN_COLUMNCLICK получает номер дополнительного элемента, по которому выполняется сортировка, из поля iSubItem структуры NM_LISTVIEW.
Функция сравнения должна выглядеть так (имя функции может быть любым):
int CALLBACK LVCompareProc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort) { int iResult; ........ return(iResult); }
Параметры lParam1 и lParam2 указывают на данные, относящиеся к сравниваемым элементам. Параметр lParamSort содержит значение, которое было передано через последний параметр макрокоманде ListView_SortItems. В нашем случае это номер дополнительного элемента списка, по которому выполняется сравнение.
Пример функции сравнения вы найдете в исходных текстах приложения List Application (листинг 3.1).
LVN_BEGINLABELEDIT
LVN_ENDLABELEDIT
Если при создании органа управления List View был указан стиль LVS_EDITLABELS, пользователь сможет редактировать имена элементов списка.
Для этого достаточно выделить нужный элемент и сделать по нему щелчок левой клавишей мыши. Примерно через секунду появится окно редактирования имени "по месту". Такой способ пригоден в любом режиме работы органа управления List View.
Перед началом редактирования имени элемента списка родительское окно получает извещение LVN_BEGINLABELEDIT. Если обработчик этого сообщения возвратит ненулевое значение, редактирование будет заблокировано. Таким образом можно запретить пользователю редактировать названия некоторых элементов списка.
В простейшем случае обработчик извещения LVN_BEGINLABELEDIT может выглядеть так:
case LVN_BEGINLABELEDIT: { return 0L; break; }
Когда пользователь завершил редактирование имени элемента списка, родительскому окну передается извещение LVN_ENDLABELEDIT. При этом параметр lParam сообщения WM_NOTIFY содержит адрес структуры LV_DISPINFO.
Обработчик извещения LVN_ENDLABELEDIT может, например, обновить имя элемента в структуре данных, где это имя хранится.
Если пользователь отменил редактирование, в поле item.iItem будет находиться значение -1. В этом случае обновление выполнять не нужно:
case LVN_ENDLABELEDIT: { if((lpLvdi->item.iItem != -1) && (lpLvdi->item.pszText != NULL)) lstrcpy(lpAppinfo->szAppName, lpLvdi->item.pszText); return 0L; break; }
