Элемент управления заголовками

В этом разделе содержатся сведения о элементах программирования, используемых с элементами управления заголовками.

Общие сведения

Раздел	Содержимое
Сведения о элементах управления заголовками	Элемент управления заголовком — это окно, которое обычно размещается над столбцами текста или чисел. Он содержит заголовок для каждого столбца, и его можно разделить на части.
Использование элементов управления заголовками	В этом разделе приводятся сведения о реализации и примеры кода для элементов управления заголовками.

Макросы

Раздел	Содержимое
Header_ClearAllFilters	Очищает все фильтры для заданного элемента управления заголовком. Этот макрос можно использовать или явно отправить сообщение HDM_CLEARFILTER.
Header_ClearFilter	Очищает фильтр для заданного элемента управления заголовком. Этот макрос можно использовать или явно отправить сообщение HDM_CLEARFILTER.
Header_CreateDragImage	Создает прозрачную версию изображения элемента в существующем элементе управления заголовками. Этот макрос можно использовать или явно отправить сообщение HDM_CREATEDRAGIMAGE.
Header_DeleteItem	Удаляет элемент из элемента управления заголовком. Этот макрос можно использовать или явно отправить сообщение HDM_DELETEITEM.
Header_EditFilter	Перемещает фокус ввода в поле редактирования, когда кнопка фильтра имеет фокус.
Header_GetBitmapMargin	Возвращает ширину поля (в пикселях) растрового изображения в существующем элементе управления заголовком. Этот макрос можно использовать или явно отправить сообщение HDM_GEТБ ITMAPMARGIN.
Header_GetFocusedItem	Возвращает элемент в элементе управления заголовком с фокусом. Используйте этот макрос или явно отправьте сообщение HDM_GETFOCUSEDITEM.
Header_GetImageList	Возвращает дескриптор списка изображений, который был задан для существующего элемента управления заголовком. Этот макрос можно использовать или явно отправить сообщение HDM_GETIMAGELIST.
Header_GetItem	Получает сведения об элементе в элементе управления заголовком. Этот макрос можно использовать или явно отправлять сообщение HDM_GETITEM.
Header_GetItemCount	Возвращает количество элементов в элементе управления заголовком. Этот макрос можно использовать или явно отправить сообщение HDM_GETITEMCOUNT.
Header_GetItemDropDownRect	Возвращает координаты раскрывающейся кнопки для указанного элемента в элементе управления заголовком. Элемент управления заголовком должен иметь тип HDF_SPLIТБ UTTON. Используйте этот макрос или явно отправьте сообщение HDM_GETITEMDROPDOWNRECT.
Header_GetItemRect	Получает ограничивающий прямоугольник для заданного элемента в элементе управления заголовком. Этот макрос можно использовать или явно отправить сообщение HDM_GETITEMRECT.
Header_GetOrderArray	Возвращает текущий левый к правому порядку элементов в элементе управления заголовком. Этот макрос можно использовать или явно отправить сообщение HDM_GETORDERARRAY.
Header_GetOverflowRect	Возвращает координаты раскрывающейся области переполнения для указанного элемента управления заголовком. Элемент управления заголовком должен иметь тип HDF_SPLIТБ UTTON. Используйте этот макрос или явно отправьте сообщение HDM_GETOVERFLOWRECT.
Header_GetStateImageList	Возвращает дескриптор списка изображений, который был задан для существующего состояния элемента управления заголовком.
Header_GetUnicodeFormat	Возвращает флаг формата символов Юникода для элемента управления. Этот макрос можно использовать или явно отправить сообщение HDM_GETUNICODEFORMAT.
Header_InsertItem	Вставляет новый элемент в элемент управления заголовком. Этот макрос можно использовать или явно отправить сообщение HDM_INSERTITEM.
Header_Layout	Извлекает правильный размер и позицию элемента управления заголовком в родительском окне. Этот макрос можно использовать или явно отправлять сообщение HDM_LAYOUT.
Header_OrderToIndex	Извлекает значение индекса для элемента в зависимости от его порядка в элементе управления заголовком. Этот макрос можно использовать или явно отправить сообщение HDM_ORDERTOINDEX.
Header_SetBitmapMargin	Задает ширину поля для растрового изображения в существующем элементе управления заголовком. Этот макрос можно использовать или явно отправить сообщение HDM_SEТБ ITMAPMARGIN.
Header_SetFilterChangeTimeout	Задает интервал времени ожидания между временем изменения в атрибутах фильтра и публикацией уведомления HDN_FILTERCHANGE . Этот макрос можно использовать или явно отправить сообщение HDM_SETFILTERCHANGETIMEOUT.
Header_SetFocusedItem	Задает фокус на указанный элемент в элементе управления заголовком. Используйте этот макрос или явно отправьте сообщение HDM_SETFOCUSEDITEM.
Header_SetHotDivider	Изменяет цвет разделителя между элементами заголовка, чтобы указать назначение внешней операции перетаскивания. Этот макрос можно использовать или явно отправить сообщение HDM_SETHOTDIVIDER.
Header_SetImageList	Назначает список изображений существующему элементу управления заголовком. Этот макрос можно использовать или явно отправить сообщение HDM_SETIMAGELIST.
Header_SetItem	Задает атрибуты указанного элемента в элементе управления заголовком. Этот макрос можно использовать или явно отправить сообщение HDM_SETITEM.
Header_SetOrderArray	Задает левый порядок элементов заголовка слева направо. Этот макрос можно использовать или явно отправить сообщение HDM_SETORDERARRAY.
Header_SetStateImageList	Назначает список изображений существующему состоянию элемента управления заголовком.
Header_SetUnicodeFormat	Задает флаг формата символов ЮНИКОДа для элемента управления. Это сообщение позволяет изменить набор символов, используемый элементом управления во время выполнения, а не повторно создать элемент управления. Этот макрос можно использовать или явно отправить сообщение HDM_SETUNICODEFORMAT.

Сообщения

Раздел	Содержимое
HDM_CLEARFILTER	Очищает фильтр для заданного элемента управления заголовком. Это сообщение можно отправить явно или использовать макрос Header_ClearFilter.
HDM_CREATEDRAGIMAGE	Создает полупрозрачную версию образа элемента для использования в качестве перетаскивающего изображения. Это сообщение можно отправить явным образом или использовать макрос Header_CreateDragImage.
HDM_DELETEITEM	Удаляет элемент из элемента управления заголовком. Это сообщение можно отправить явно или использовать макрос Header_DeleteItem.
HDM_EDITFILTER	Перемещает фокус ввода в поле редактирования, когда кнопка фильтра имеет фокус.
HDM_GEТБ ITMAPMARGIN	Возвращает ширину поля растрового изображения для элемента управления заголовком. Это сообщение можно отправить явно или использовать макрос Header_GetBitmapMargin.
HDM_GETFOCUSEDITEM	Возвращает элемент в элементе управления заголовком с фокусом. Отправьте это сообщение явным образом или с помощью макроса Header_GetFocusedItem. Окно получает это сообщение через функцию WindowProc .
HDM_GETIMAGELIST	Возвращает дескриптор списка изображений, который был задан для существующего элемента управления заголовком. Это сообщение можно отправить явно или использовать макрос Header_GetImageList или Header_GetStateImageList.
HDM_GETITEM	Получает сведения об элементе в элементе управления заголовком. Это сообщение можно отправить явно или использовать макрос Header_GetItem.
HDM_GETITEMCOUNT	Возвращает количество элементов в элементе управления заголовком. Это сообщение можно отправить явным образом или использовать макрос Header_GetItemCount.
HDM_GETITEMDROPDOWNRECT	Получает ограничивающий прямоугольник разделяющей кнопки для элемента заголовка с стилем HDF_SPLIТБ UTTON. Отправьте это сообщение явным образом или с помощьюмакроса Header_GetItemDropDownRect.
HDM_GETITEMRECT	Получает ограничивающий прямоугольник для заданного элемента в элементе управления заголовком. Это сообщение можно отправить явно или использовать макрос Header_GetItemRect.
HDM_GETORDERARRAY	Возвращает текущий левый к правому порядку элементов в элементе управления заголовком. Это сообщение можно отправить явно или использовать макрос Header_GetOrderArray.
HDM_GETOVERFLOWRECT	Получает ограничивающий прямоугольник кнопки переполнения, когда стиль HDS_OVERFLOW задан в элементе управления заголовком и кнопка переполнения отображается. Отправьте это сообщение явным образом или с помощьюмакроса Header_GetOverflowRect.
HDM_GETUNICODEFORMAT	Возвращает флаг формата символов Юникода для элемента управления. Это сообщение можно отправить явно или использовать макрос Header_GetUnicodeFormat.
HDM_HITTEST	Проверяет точку, чтобы определить, какой элемент заголовка, если он есть, находится в указанной точке.
HDM_INSERTITEM	Вставляет новый элемент в элемент управления заголовком. Это сообщение можно отправить явно или использовать макрос Header_InsertItem.
HDM_LAYOUT	Извлекает сведения, используемые для задания размера и положения элемента управления заголовком в целевом прямоугольнике родительского окна. Это сообщение можно отправить явно или использовать макрос Header_Layout.
HDM_ORDERTOINDEX	Извлекает значение индекса для элемента в зависимости от его порядка в элементе управления заголовком. Это сообщение можно отправить явно или использовать макрос Header_OrderToIndex.
HDM_SEТБ ITMAPMARGIN	Задает ширину поля, указанного в пикселях, растрового изображения в существующем элементе управления заголовком. Это сообщение можно отправить явным образом или использовать макрос Header_SetBitmapMargin.
HDM_SETFILTERCHANGETIMEOUT	Задает интервал времени ожидания между временем изменения в атрибутах фильтра и публикацией уведомления HDN_FILTERCHANGE . Это сообщение можно отправить явным образом или использовать макрос Header_SetFilterChangeTimeout.
HDM_SETFOCUSEDITEM	Задает фокус на указанный элемент в элементе управления заголовком. Отправьте это сообщение явным образом или с помощью макроса Header_SetFocusedItem.
HDM_SETHOTDIVIDER	Изменяет цвет разделителя между элементами заголовка, чтобы указать назначение внешней операции перетаскивания. Это сообщение можно отправить явно или использовать макрос Header_SetHotDivider.
HDM_SETIMAGELIST	Назначает список изображений существующему элементу управления заголовком. Это сообщение можно отправить явно или использовать макрос Header_SetImageList или Header_SetStateImageList.
HDM_SETITEM	Задает атрибуты указанного элемента в элементе управления заголовком. Это сообщение можно отправить явно или использовать макрос Header_SetItem.
HDM_SETORDERARRAY	Задает левый порядок элементов заголовка слева направо. Это сообщение можно отправить явно или использовать макрос Header_SetOrderArray.
HDM_SETUNICODEFORMAT	Задает флаг формата символов ЮНИКОДа для элемента управления. Это сообщение позволяет изменить набор символов, используемый элементом управления во время выполнения, а не повторно создать элемент управления. Это сообщение можно отправить явным образом или использовать макрос Header_SetUnicodeFormat.
HDM_TRANSLATEACCELERATOR	Не реализовано.

Notifications

Раздел	Содержимое
HDN_BEGINDRAG	Отправляется элементом управления заголовком при начале операции перетаскивания на одном из его элементов. Этот код уведомления отправляется только элементами управления заголовками, заданными в стиле HDS_DRAGDROP. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
HDN_BEGINFILTEREDIT	Уведомляет родительское окно элемента управления заголовком о начале изменения фильтра. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
HDN_BEGINTRACK	Уведомляет родительское окно элемента управления заголовком о том, что пользователь начал перетаскивать разделитель в элементе управления (т. е. пользователь нажимал левую кнопку мыши, когда курсор мыши находится на разделителях в элементе управления заголовком). Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
HDN_DIVIDERDBLCLICK	Уведомляет родительское окно элемента управления заголовком, что пользователь дважды щелкнул область разделителя элемента управления. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
HDN_DROPDOWN	Отправляется элементом управления заголовком в родительский элемент управления при щелчке стрелки раскрывающегося списка в элементе управления заголовком. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
HDN_ENDDRAG	Отправляется элементом управления заголовком при завершении операции перетаскивания на одном из его элементов. Этот код уведомления отправляется в виде сообщения WM_NOTIFY. Только элементы управления заголовками , заданные в стиле HDS_DRAGDROP , отправляют это уведомление.
HDN_ENDFILTEREDIT	Уведомляет родительское окно элемента управления заголовком о завершении изменения фильтра. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
HDN_ENDTRACK	Уведомляет родительское окно элемента управления заголовком о том, что пользователь завершил перетаскивание разделителя. Этот код уведомления, отправленный в виде сообщения WM_NOTIFY .
HDN_FILTERBTNCLICK	Уведомляет родительское окно элемента управления заголовком при нажатии кнопки фильтра или в ответ на сообщение HDM_SETITEM.
HDN_FILTERCHANGE	Уведомляет родительское окно элемента управления заголовком о том, что атрибуты фильтра элементов управления заголовками изменяются или редактируются.
HDN_GETDISPINFO	Отправляется владельцу элемента управления заголовком, когда элементу управления требуются сведения о элементе заголовка обратного вызова. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
HDN_ITEMCHANGED	Уведомляет родительское окно элемента управления заголовком об изменении атрибутов элемента заголовка. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
HDN_ITEMCHANGING	Уведомляет родительское окно элемента управления заголовком о том, что атрибуты элемента заголовка будут изменены. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
HDN_ITEMCLICK	Уведомляет родительское окно элемента управления заголовком о том, что пользователь щелкнул элемент управления. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
HDN_ITEMDBLCLICK	Уведомляет родительское окно элемента управления заголовком о том, что пользователь дважды щелкнул элемент управления. Этот код уведомления отправляется в виде сообщения WM_NOTIFY. Только элементы управления заголовками , заданные в стиле HDS_BUTTONS , отправляют это уведомление.
HDN_ITEMKEYDOWN	Уведомляет родительское окно элемента управления заголовком о том, что клавиша была нажата выбранным элементом. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
HDN_ITEMSTATEICONCLICK	Уведомляет родительское окно элемента управления заголовком о том, что пользователь щелкнул значок состояния элемента.
HDN_OVERFLOWCLICK	Отправляется элементом управления заголовком в родительский элемент управления при нажатии кнопки переполнения заголовка. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
HDN_TRACK	Уведомляет родительское окно элемента управления заголовком о том, что пользователь перетаскивает разделитель в элементе управления заголовком. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
NM_CUSTOMDRAW (заголовок)	Отправляется элементом управления заголовком, чтобы уведомить его родительское окно об операциях рисования. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
NM_RCLICK (заголовок)	Уведомляет родительское окно элемента управления "Дерево" о том, что пользователь щелкнул правую кнопку мыши в элементе управления. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
NM_RELEASEDCAPTURE (заголовок)	Уведомляет родительское окно элемента управления заголовком о том, что элемент управления освобождает запись мыши. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.

Константы

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