Функция CreateToolbarEx (commctrl.h)

Создает окно панели инструментов и добавляет указанные кнопки на панель инструментов.

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

 

Синтаксис

HWND CreateToolbarEx(
  HWND        hwnd,
  DWORD       ws,
  UINT        wID,
  int         nBitmaps,
  HINSTANCE   hBMInst,
  UINT_PTR    wBMID,
  LPCTBBUTTON lpButtons,
  int         iNumButtons,
  int         dxButton,
  int         dyButton,
  int         dxBitmap,
  int         dyBitmap,
  UINT        uStructSize
);

Параметры

hwnd

Тип: HWND

Дескриптор родительского окна панели инструментов.

ws

Тип: DWORD

Стили окна для панели инструментов. Стиль WS_CHILD включен по умолчанию. Этот параметр также может включать сочетание стилей, как описано в разделе Элементы управления панелью инструментов и Стили кнопок.

wID

Тип: UINT

Идентификатор элемента управления для панели инструментов.

nBitmaps

Тип: int

Количество изображений кнопок, содержащихся в растровом изображении, заданном hBMInst и wBMID.

hBMInst

Тип: HINSTANCE

Экземпляр модуля с исполняемым файлом, содержащим ресурс растрового изображения.

wBMID

Тип: UINT_PTR

Идентификатор ресурса для ресурса растрового рисунка. Если hBMInst имеет значение NULL, этот параметр должен быть допустимым дескриптором растрового изображения.

lpButtons

Тип: LPCTBBUTTON

Указатель на массив структур TBBUTTON , содержащих сведения о кнопках для добавления на панель инструментов.

iNumButtons

Тип: int

Количество кнопок, добавляемых на панель инструментов.

dxButton

Тип: int

Ширина (в пикселях) кнопок, добавляемых на панель инструментов.

dyButton

Тип: int

Высота (в пикселях) кнопок для добавления на панель инструментов.

dxBitmap

Тип: int

Ширина (в пикселях) изображений кнопок для добавления к кнопкам на панели инструментов.

dyBitmap

Тип: int

Высота (в пикселях) изображений кнопок для добавления к кнопкам на панели инструментов.

uStructSize

Тип: UINT

Размер структуры TBBUTTON .

Возвращаемое значение

Тип: HWND

Возвращает дескриптор окна на панель инструментов в случае успешного выполнения или значение NULL в противном случае. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.

Комментарии

Windows 95: система может поддерживать не более 16 364 дескрипторов окон.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	commctrl.h
Библиотека	Comctl32.lib
DLL	Comctl32.dll
Набор API	ext-ms-win-shell-comctl32-window-l1-1-0 (появилось в Windows 10, версия 10.0.14393)