сообщение 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 [только классические приложения] |
| Заголовок |
|
| Имя в кодировке Юникод и ANSI |
TB_ADDBUTTONSW (Юникод) и TB_ADDBUTTONSA (ANSI) |