сообщение TB_ADDBUTTONS

  • Статья

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

Параметры

wParam

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

lParam

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

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

Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае.

Комментарии

Если панель инструментов была создана с помощью функции CreateWindowEx, перед отправкой TB_ADDBUTTONS необходимо отправить сообщение TB_BUTTONSTRUCTSIZE на панель инструментов.

Сведения о назначении растровых изображений для кнопок панели инструментов из одного или нескольких списков изображений см. в TB_SETIMAGELIST .

Примеры

В следующем примере кода три кнопки добавляются на панель инструментов с использованием стандартного системного растрового изображения для кнопок просмотра. Сообщение TB_ADDBITMAP возвращает индекс первого изображения кнопки в списке изображений. Отдельные изображения идентифицируются по их смещениям от этого значения.

TBADDBITMAP tbAddBitmap;
tbAddBitmap.hInst = HINST_COMMCTRL;
tbAddBitmap.nID = IDB_VIEW_SMALL_COLOR;

// There are 12 items in IDB_VIEW_SMALL_COLOR.  However, because this is a standard
// system-defined bitmap, the wParam (nButtons) is ignored.
//
// hWndToolbar is the handle of the toolbar window.
//
// Do not forget to send TB_BUTTONSTRUCTSIZE if the toolbar was created
// by using CreateWindowEx.
//
int stdidx = SendMessage(hWndToolbar, TB_ADDBITMAP, 0, (LPARAM)&tbAddBitmap);

// Define the buttons. 
// IDM_SETLARGEICONVIEW and so on are application-defined command IDs.

const int numButtons = 3;
TBBUTTON tbButtonsAdd[numButtons] = 
{
    {stdidx + VIEW_LARGEICONS, IDM_SETLARGEICONVIEW, TBSTATE_ENABLED, BTNS_BUTTON},
    {stdidx + VIEW_SMALLICONS, IDM_SETSMALLICONVIEW, TBSTATE_ENABLED, BTNS_BUTTON},
    {stdidx + VIEW_DETAILS, IDM_SETDETAILSVIEW, TBSTATE_ENABLED, BTNS_BUTTON}
}; 

// Add the view buttons.
SendMessage(hWndToolbar, TB_ADDBUTTONS, numButtons, (LPARAM)tbButtonsAdd);

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Заголовок
Commctrl.h
Имя в кодировке Юникод и ANSI
 TB_ADDBUTTONSW (Юникод) и TB_ADDBUTTONSA (ANSI)

См. также раздел

Значения индекса изображения стандартной кнопки панели инструментов