Панель инструментов

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

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

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

Функции

Раздел	Содержимое
CreateMappedBitmap	Создает растровое изображение для использования на панели инструментов.
CreateToolbarEx	Создает окно панели инструментов и добавляет указанные кнопки на панель инструментов. Примечание. Эта функция устарела, так как она не поддерживает все функции панелей инструментов. Вместо этого используйте CreateWindowEx . Примеры см. в разделе "Использование элементов управления панелью инструментов".

Сообщения

Раздел	Содержимое
ТБ_ADDBITMAP	Добавляет один или несколько изображений в список изображений кнопок, доступных для панели инструментов.
ТБ_ADDBUTTONS	Добавляет одну или несколько кнопок на панель инструментов.
ТБ_ADDSTRING	Добавляет новую строку в пул строк панели инструментов.
ТБ_AUTOSIZE	Вызывает изменение размера панели инструментов.
ТБ_BUTTONCOUNT	Извлекает количество кнопок, которые сейчас находятся на панели инструментов.
ТБ_BUTTONSTRUCTSIZE	Задает размер структуры ТБ BUTTON.
ТБ_CHANGEBITMAP	Изменяет растровое изображение для кнопки на панели инструментов.
ТБ_CHECКБ UTTON	Проверяет или отменяет проверка заданную кнопку на панели инструментов.
ТБ_COMMANDTOINDEX	Извлекает отсчитываемый от нуля индекс для кнопки, связанной с указанным идентификатором команды.
ТБ_CUSTOMIZE	Отображает диалоговое окно "Настройка панели инструментов ".
ТБ_DELETEBUTTON	Удаляет кнопку на панели инструментов.
ТБ_ENABLEBUTTON	Включает или отключает указанную кнопку на панели инструментов.
ТБ_GETANCHORHIGHLIGHT	Извлекает параметр выделения привязки для панели инструментов.
ТБ_GEТБ ITMAP	Извлекает индекс растрового изображения, связанного с кнопкой на панели инструментов.
ТБ_GEТБ ITMAPFLAGS	Извлекает флаги, описывающие тип используемого растрового изображения.
ТБ_GEТБ UTTON	Извлекает сведения об указанной кнопке на панели инструментов.
ТБ_GEТБ UTTONINFO	Извлекает расширенные сведения для кнопки на панели инструментов.
ТБ_GEТБ UTTONSIZE	Извлекает текущую ширину и высоту кнопок панели инструментов в пикселях.
ТБ_GEТБ UTTONTEXT	Извлекает отображаемый текст кнопки на панели инструментов.
ТБ_GETCOLORSCHEME	Извлекает сведения о цветовой схеме из элемента управления панели инструментов.
ТБ_GETDISABLEDIMAGELIST	Извлекает список изображений, который элемент управления панели инструментов использует для отображения неактивных кнопок.
ТБ_GETEXTENDEDSTYLE	Извлекает расширенные стили для элемента управления панелью инструментов.
ТБ_GETHOTIMAGELIST	Извлекает список изображений, используемый элементом управления панели инструментов для отображения горячих кнопок.
ТБ_GETHOTITEM	Извлекает индекс горячего элемента на панели инструментов.
ТБ_GETIDEALSIZE	Возвращает идеальный размер панели инструментов.
ТБ_GETIMAGELIST	Извлекает список изображений, используемый элементом управления панели инструментов для отображения кнопок в их состоянии по умолчанию. Элемент управления панели инструментов использует этот список изображений для отображения кнопок, если они не являются горячими или отключенными.
ТБ_GETIMAGELISTCOUNT	Возвращает количество списков изображений, связанных с панелью инструментов.
ТБ_GETINSERTMARK	Извлекает текущую метку вставки для панели инструментов.
ТБ_GETINSERTMARKCOLOR	Извлекает цвет, используемый для рисования метки вставки для панели инструментов.
ТБ_GETITEMDROPDOWNRECT	Возвращает ограничивающий прямоугольник раскрывающегося окна для элемента панели инструментов с BTNS_DROPDOWN стиля.
ТБ_GETITEMRECT	Извлекает ограничивающий прямоугольник кнопки на панели инструментов.
ТБ_GETMAXSIZE	Извлекает общий размер всех видимых кнопок и разделителей на панели инструментов.
ТБ_GETMETRICS	Извлекает метрики элемента управления панели инструментов.
ТБ_GETOBJECT	Извлекает IDropTarget для элемента управления панели инструментов.
ТБ_GETPADDING	Извлекает заполнение для элемента управления панели инструментов.
ТБ_GETPRESSEDIMAGELIST	Возвращает список изображений, который элемент управления панели инструментов использует для отображения кнопок в состоянии нажатия.
ТБ_GETRECT	Извлекает ограничивающий прямоугольник для указанной кнопки панели инструментов.
ТБ_GETROWS	Извлекает количество строк кнопок на панели инструментов с помощью стиля ТБSTYLE_WRAPABLE.
ТБ_GETSTATE	Извлекает сведения о состоянии указанной кнопки на панели инструментов, например о включении, нажатии или проверка.
ТБ_GETSTRING	Извлекает строку из пула строк панели инструментов.
ТБ_GETSTYLE	Извлекает стили, используемые в настоящее время для элемента управления панелью инструментов.
ТБ_GETTEXTROWS	Извлекает максимальное количество текстовых строк, которые можно отобразить на кнопке панели инструментов.
ТБ_GETTOOLTIPS	Извлекает дескриптор в элемент управления подсказки, если он есть, связанный с панелью инструментов.
ТБ_GETUNICODEFORMAT	Извлекает флаг формата символов Юникода для элемента управления.
ТБ_HASACCELERATOR	Предназначено для внутреннего использования; не рекомендуется использовать в приложениях. Извлекает количество кнопок панели инструментов с указанным символом акселератора.
ТБ_HIDEBUTTON	Скрывает или отображает указанную кнопку на панели инструментов.
ТБ_HITTEST	Определяет, где находится точка в элементе управления панели инструментов.
ТБ_INDETERMINATE	Задает или очищает неопределенное состояние указанной кнопки на панели инструментов.
ТБ_INSERТБ UTTON	Вставляет кнопку на панели инструментов.
ТБ_INSERTMARKHITTEST	Извлекает сведения о метке вставки для точки на панели инструментов.
ТБ_ISBUTTONCHECKED	Определяет, проверка ли указанная кнопка на панели инструментов.
ТБ_ISBUTTONENABLED	Определяет, включена ли указанная кнопка на панели инструментов.
ТБ_ISBUTTONHIDDEN	Определяет, скрыта ли указанная кнопка на панели инструментов.
ТБ_ISBUTTONHIGHLIGHTED	Проверяет состояние выделения кнопки панели инструментов.
ТБ_ISBUTTONINDETERMINATE	Определяет, не определена ли указанная кнопка на панели инструментов.
ТБ_ISBUTTONPRESSED	Определяет, нажимается ли указанная кнопка на панели инструментов.
ТБ_LOADIMAGES	Загружает системные изображения кнопок в список изображений элемента управления панели инструментов.
ТБ_MAPACCELERATOR	Определяет идентификатор кнопки, соответствующей указанному символу акселератора.
ТБ_MARКБ UTTON	Задает состояние выделения заданной кнопки в элементе управления панелью инструментов.
ТБ_MOVEBUTTON	Перемещает кнопку из одного индекса в другой.
ТБ_PRESSBUTTON	Нажимает или освобождает указанную кнопку на панели инструментов.
ТБ_REPLACEBITMAP	Заменяет существующее растровое изображение новым растровым изображением.
ТБ_SAVERESTORE	Отправьте это сообщение, чтобы инициировать сохранение или восстановление состояния панели инструментов.
ТБ_SETANCHORHIGHLIGHT	Задает параметр выделения привязки для панели инструментов.
ТБ_SEТБ ITMAPSIZE	Задает размер битовых изображений, добавляемых на панель инструментов.
ТБ_SEТБ OUNDINGSIZE	Предназначено для внутреннего использования; не рекомендуется использовать в приложениях. Задает ограничивающий размер элемента управления панели инструментов с несколькими столбцами.
ТБ_SEТБ UTTONINFO	Задает сведения для существующей кнопки на панели инструментов.
ТБ_SEТБ UTTONSIZE	Задает размер кнопок на панели инструментов.
ТБ_SEТБ UTTONWIDTH	Задает минимальную и максимальную ширину кнопки в элементе управления панели инструментов.
ТБ_SETCMDID	Задает идентификатор команды кнопки панели инструментов.
ТБ_SETCOLORSCHEME	Задает сведения о цветовой схеме для элемента управления панели инструментов.
ТБ_SETDISABLEDIMAGELIST	Задает список изображений, используемый элементом управления панели инструментов для отображения отключенных кнопок.
ТБ_SETDRAWTEXTFLAGS	Задает флаги рисования текста для панели инструментов.
ТБ_SETEXTENDEDSTYLE	Задает расширенные стили для элемента управления панелью инструментов.
ТБ_SETHOTIMAGELIST	Задает список изображений, используемый элементом управления панели инструментов для отображения горячих кнопок.
ТБ_SETHOTITEM	Задает горячий элемент на панели инструментов.
ТБ_SETHOTITEM2	Задает горячий элемент на панели инструментов.
ТБ_SETIMAGELIST	Задает список изображений, используемый на панели инструментов для отображения кнопок, которые находятся в состоянии по умолчанию.
ТБ_SETINDENT	Задает отступ для первой кнопки в элементе управления панелью инструментов.
ТБ_SETINSERTMARK	Задает текущую метку вставки для панели инструментов.
ТБ_SETINSERTMARKCOLOR	Задает цвет, используемый для рисования метки вставки для панели инструментов.
ТБ_SETLISTGAP	Задает расстояние между кнопками панели инструментов на определенной панели инструментов.
ТБ_SETMAXTEXTROWS	Задает максимальное количество текстовых строк, отображаемых на кнопке панели инструментов.
ТБ_SETMETRICS	Задает метрики элемента управления панели инструментов.
ТБ_SETPADDING	Задает заполнение для элемента управления панели инструментов.
ТБ_SETPARENT	Задает окно, в которое элемент управления панели инструментов отправляет коды уведомлений.
ТБ_SETPRESSEDIMAGELIST	Задает список изображений, который панель инструментов использует для отображения кнопок, которые находятся в состоянии нажатия.
ТБ_SETROWS	Задает количество строк кнопок на панели инструментов.
ТБ_SETSTATE	Задает состояние указанной кнопки на панели инструментов.
ТБ_SETSTYLE	Задает стиль элемента управления панели инструментов.
ТБ_SETTOOLTIPS	Связывает элемент управления подсказки с панелью инструментов.
ТБ_SETUNICODEFORMAT	Задает флаг формата символов Юникода для элемента управления. Это сообщение позволяет изменить набор символов, используемый элементом управления во время выполнения, а не повторно создать элемент управления.
ТБ_SETWINDOWTHEME	Задает визуальный стиль элемента управления панели инструментов.
ТБ_TRANSLATEACCELERATOR	Передает на панель инструментов сообщение клавиатуры.

Notifications

Раздел	Содержимое
NM_CHAR (панель инструментов)	Отправляется панелью инструментов при получении сообщения WM_CHAR. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
NM_CLICK (панель инструментов)	Отправляется элементом управления панели инструментов, когда пользователь щелкает элемент с левой кнопкой мыши. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
NM_CUSTOMDRAW (панель инструментов)	Отправляет панель инструментов, чтобы уведомить родительское окно о операциях рисования. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
NM_DBLCLK (панель инструментов)	Уведомляет родительское окно элемента управления панели инструментов, что пользователь дважды щелкнул левую кнопку мыши в элементе управления. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
NM_KEYDOWN (панель инструментов)	Отправляется элементом управления, когда элемент управления имеет фокус клавиатуры, и пользователь нажимает клавишу. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
NM_LDOWN	Уведомляет родительское окно панели инструментов о нажатии левой кнопки мыши. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
NM_RCLICK (панель инструментов)	Отправляется элементом управления панели инструментов, когда пользователь щелкает панель инструментов правой кнопкой мыши. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
NM_RDBLCLK (панель инструментов)	Уведомляет родительское окно элемента управления о том, что пользователь дважды щелкнул правую кнопку мыши в элементе управления. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
NM_RELEASEDCAPTURE (панель инструментов)	Уведомляет родительское окно элемента управления панели инструментов о том, что элемент управления освобождает запись мыши. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
NM_TOOLTIPSCREATED (панель инструментов)	Уведомляет родительское окно панели инструментов о том, что панель инструментов создала элемент управления подсказкой. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_BEGINADJUST	Уведомляет родительское окно панели инструментов о том, что пользователь начал настраивать панель инструментов. Этот код сообщения отправляется в виде сообщения WM_NOTIFY.
ТБN_BEGINDRAG	Уведомляет родительское окно панели инструментов о том, что пользователь начал перетаскивать кнопку на панели инструментов. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_CUSTHELP	Уведомляет родительское окно панели инструментов о том, что пользователь выбрал кнопку справки в диалоговом окне "Настройка панели инструментов". Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_DELETINGBUTTON	Отправляется элементом управления панели инструментов при удалении кнопки.
ТБN_DRAGOUT	Отправляется элементом управления панели инструментов, когда пользователь нажимает кнопку, а затем перемещает курсор с кнопки. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_DRAGOVER	Определяет, следует ли отправлять сообщение ТБ_MARКБ UTTON для кнопки, перетаскиваемой поверх. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_DROPDOWN	Отправляется элементом управления панели инструментов, когда пользователь нажимает кнопку раскрывающегося списка. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_DUPACCELERATOR	Определяет, можно ли использовать клавишу акселератора на двух или более активных панелях инструментов. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_ENDADJUST	Уведомляет родительское окно панели инструментов о том, что пользователь перестал настраивать панель инструментов. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_ENDDRAG	Уведомляет родительское окно панели инструментов о том, что пользователь перестал перетаскивать кнопку на панели инструментов. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_GEТБ UTTONINFO	Извлекает сведения о настройке панели инструментов и уведомляет родительское окно панели инструментов о любых изменениях, внесенных на панель инструментов. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_GETDISPINFO	Извлекает сведения о отображении элемента панели инструментов. Это уведомление отправляется в виде сообщения WM_NOTIFY.
ТБN_GETINFOTIP	Извлекает сведения о подсказке для элемента панели инструментов. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_GETOBJECT	Отправляется элементом управления панели инструментов, использующим стиль ТБSTYLE_REGISTERDROP для запроса целевого объекта удаления, когда указатель передает одну из кнопок. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_HOTITEMCHANGE	Отправляется элементом управления панели инструментов при изменении горячего (выделенного) элемента. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_INITCUSTOMIZE	Уведомляет родительское окно панели инструментов о начале настройки. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_MAPACCELERATOR	Запрашивает индекс кнопки на панели инструментов, соответствующей указанному символу акселератора. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_QUERYDELETE	Уведомляет родительское окно панели инструментов о том, может ли кнопка быть удалена из панели инструментов, пока пользователь настраивает панель инструментов. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_QUERYINSERT	Уведомляет родительское окно панели инструментов, можно ли вставить кнопку слева от указанной кнопки, пока пользователь настраивает панель инструментов. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_RESET	Уведомляет родительское окно панели инструментов о том, что пользователь сбросил содержимое диалогового окна "Настройка панели инструментов". Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_RESTORE	Уведомляет родительское окно панели инструментов о том, что панель инструментов находится в процессе восстановления. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_SAVE	Уведомляет родительское окно панели инструментов о том, что панель инструментов находится в процессе сохранения. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_TOOLBARCHANGE	Уведомляет родительское окно панели инструментов о том, что пользователь настроил панель инструментов. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_WRAPACCELERATOR	Запрашивает индекс кнопки на одной или нескольких панелях инструментов, соответствующих указанному символу акселератора. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
ТБN_WRAPHOTITEM	Уведомляет приложение с двумя или более панелями инструментов о том, что горячий элемент будет изменен. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.

Структуры

Раздел	Содержимое
COLORMAP	Содержит сведения, используемые функцией CreateMappedBitmap для сопоставления цветов растрового изображения.
NM ТБ CUSTOMDRAW	Содержит сведения, относящиеся к коду уведомлений NM_CUSTOMDRAW , отправляемым элементом управления панели инструментов.
NM ТБ DISPINFO	Содержит и получает сведения о отображении элемента панели инструментов. Эта структура используется с кодом уведомления ТБN_GETDISPINFO.
NM ТБ GETINFOTIP	Содержит и получает сведения о подсказке для элемента панели инструментов. Эта структура используется с кодом уведомления ТБN_GETINFOTIP.
NM ТБ HOTITEM	Содержит сведения, используемые с кодом уведомления ТБN_HOTITEMCHANGE.
NM ТБ RESTORE	Позволяет приложениям извлекать сведения, которые были помещены в NM ТБ SAVE при сохранении состояния панели инструментов. Эта структура передается приложениям при получении кода уведомления ТБN_RESTORE.
NM ТБ SAVE	Эта структура передается приложениям при получении кода уведомления ТБN_SAVE. Он содержит сведения о кнопке, которую сейчас сохраняется. Приложения могут изменять значения элементов для сохранения дополнительных сведений.
NMTOOLBAR	Содержит сведения, используемые для обработки кодов уведомлений панели инструментов. Эта структура заменяет структуру ТБ NOTIFY.
ТБ ADDBITMAP	Добавляет растровое изображение, содержащее изображения кнопок на панели инструментов.
ТБ BUTTON	Содержит сведения о кнопке на панели инструментов.
ТБ BUTTONINFO	Содержит или получает сведения для определенной кнопки на панели инструментов.
ТБ INSERTMARK	Содержит сведения о метке вставки в элементе управления панелью инструментов.
ТБ МЕТРИКИ	Определяет метрики панели инструментов, которая используется для сжатия или расширения элементов панели инструментов.
ТБ REPLACEBITMAP	Используется с сообщением ТБ_REPLACEBITMAP для замены одной растровой карты панели инструментов другим.
ТБ SAVEPARAMS	Указывает расположение в реестре, где ТБ_SAVERESTORE сообщения хранятся и извлекаются сведения о состоянии панели инструментов.

Константы

Раздел	Содержимое
Состояния кнопки панели инструментов	В этом разделе перечислены состояния кнопки панели инструментов.
Стили элементов управления панели инструментов и кнопки	Следующие стили окон относятся к панелям инструментов. Они объединяются с другими стилями окон при создании панели инструментов. Примечание для common Controls версии 6.00, если визуальный стиль используется с панелью инструментов, кнопки всегда прозрачны независимо от параметра стиля. В противном случае поведение прозрачности нормально, как указано в использовании стиля ТБSTYLE_FLAT или ТБSTYLE_TRANSPARENT. Примечание. Comctl32.dll версии 6 не распространяется, но она включена в Windows или более поздней версии. Чтобы использовать Comctl32.dll версии 6, укажите его в манифесте. Дополнительные сведения о манифестах см. в разделе "Включение визуальных стилей".
Расширенные стили панели инструментов	В этом разделе перечислены расширенные стили, поддерживаемые элементами управления панелью инструментов.
Значения индекса изображения стандартной кнопки панели инструментов	В этом разделе указаны значения индексов изображений в стандартных растровых изображениях.