CToolBarCtrl::AddButtons

BOOL AddButtons ( int nNumButtons, LPTBBUTTON lpButtons );

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

Ненулевое значение, если успешно; противном случае нулевой.

Параметры

nNumButtons

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

lpButtons

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

Примечания

Эта функция вызывается для добавления одной или нескольких кнопок в элемент управления toolbar.

LpButtons указатель указывает массив структур TBBUTTON . Каждая структура TBBUTTON связывает кнопку добавления с стиль кнопки, изображения и/или строка, Идентификатор команды, государство и определяемых пользователем данных:

typedef struct _TBBUTTO&N {}
int iBitmap; / / с нуля индекс кнопки изображения
int idCommand; nbsp; / / чтобы посылаться при нажатии кнопки
FsState БАЙТ;   / / кнопку государства--см.ниже
FsStyle БАЙТ;   / / кнопку Стиль--см.ниже
DWORD dwData;   / / определенное приложением значение
int iString; / / начинающийся с нуля индекс кнопки пометить строку
} TBBUTTON

Членами являются:

iBitmap

Начинающийся с нуля индекс кнопки. NULL , если нет изображения для этой кнопки.

idCommand

Команда идентификатор, связанный с кнопкой. Этот идентификатор отправляется в сообщения WM_COMMAND , при выборе кнопки. Если член fsStyle имеет значение TBSTYLE_SEP , этот член должен быть нулевым.

fsState

Флаги состояния кнопки. Это может быть комбинацией значений, перечисленных ниже:

TBSTATE_CHECKED Кнопка имеет TBSTYLE_CHECKED стиль и время нажатия.
TBSTATE_E&NABLEDnbsp; Кнопка ввода данных пользователем. Кнопка, которая не имеет это состояние не принимает пользовательский ввод и отображается серым цветом.
TBSTATE_HIDDE&Nnbsp; Кнопка не видна и не может принимать ввод пользователя.
TBSTATE_I&NDETERMINATEnbsp; Кнопка недоступна.
TBSTATE_PRESSED Кнопка нажата.
TBSTATE_WRAPnbsp; Разрыв строки соответствует кнопке. Кнопка необходимо также иметь штат TBSTATE_E&NABLED.

fsStyle

Стиль кнопки. Это может быть комбинацией значений, перечисленных ниже:

TBSTYLE_BUTTO&Nnbsp; Создает стандартный кнопка.
TBSTYLE_CHECKnbsp; Создает кнопку, которая переключает между прессованных и ненажатое каждый раз, когда пользователь щелкает его. Кнопка имеет цвет фона, когда он находится в нажатом состоянии. & nbsp;
TBSTYLE_CHECKGROUP Создает кнопку check, которая остается нажатой до тех пор, пока нажатия другой кнопки в группе.
TBSTYLE_GROUP Создает кнопку, которая остается нажатой до тех пор, пока нажатия другой кнопки в группе.
TBSTYLE_SEP Создает разделитель, предоставляя небольшой разрыв между группами кнопку. Кнопка, которой этот стиль не получает ввод пользователя.

dwData

Определяемые пользователем данных.

iString

Начинающийся с нуля индекс строки, которую требуется использовать в качестве надписи кнопки. NULL , если нет строка не для этой кнопки.

Изображения и/или строка, индекс, вы предоставляете должны ранее были добавлены в список элемента управления панели инструментов, с помощью AddBitmap, AddStringи/или AddStrings.

Обзор CToolBarCtrl | Члены класса | Иерархическая схема

См. также CToolBarCtrl::InsertButton, CToolBarCtrl::DeleteButton, CToolBarCtrl::AddBitmap, CToolBarCtrl::AddString, CToolBarCtrl::AddStrings

Index