Поделиться через


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

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

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

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

Макросы

Раздел Содержимое
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.

Константы

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