CToolBarCtrl::AddButtons
Добавляет один или несколько кнопок к элементу управления " Панель инструментов.
BOOL AddButtons(
int nNumButtons,
LPTBBUTTON lpButtons
);
Параметры
nNumButtons
Число кнопок для добавления.lpButtons
Адрес массива структур TBBUTTON, содержащий сведения о кнопках для добавления.Должно быть одинаковое число элементов в массиве, как кнопки, указанном nNumButtons.
Возвращаемое значение
Ненулевой, если успешно; в противном случае – нуль.
Заметки
Точки указателя lpButtons на массив структур TBBUTTON.Каждая структура TBBUTTON связывает добавляемым кнопка со стилем кнопки образом или строкой, идентификатор команды, состоянием и определяемыми пользователем данными.
typedef struct _TBBUTTON {
int iBitmap;// zero-based index of button image
int idCommand; // command to be sent when button pressed
BYTE fsState; // button state--see below
BYTE fsStyle; // button style--see below
DWORD dwData; // application-defined value
int iString;// zero-based index of button label string
} TBBUTTON;
Члены следующим образом:
iBitmap
Индекс, начинающийся с нуля образа кнопки, -1, если нет образа для данной кнопки.idCommand
Идентификатор команды, связанный с кнопкой.Этот идентификатор отправки в сообщении WM_COMMAND когда кнопка выбрана.Если участник fsStyle имеет значение TBSTYLE_SEP, то этот элемент должен быть равен нулю.fsState
Национальные флаги кнопки.Может оказаться сочетание значений, перечисленных ниже.TBSTATE_CHECKED кнопка имеет стиль TBSTYLE_CHECKED и отжимается.
TBSTATE_ENABLED кнопка принимает входные данные пользователя.Кнопка, не имеющий это состояние не принимает входные данные пользователя и отображается серым цветом.
TBSTATE_HIDDEN кнопка не отображается и не может получить входные данные пользователя.
TBSTATE_INDETERMINATE кнопка отображается серым цветом.
TBSTATE_PRESSED кнопку отжимается.
Разрывы строк TBSTATE_WRAP a выполните кнопкой.Кнопка должна иметь состояние TBSTATE_ENABLED.
fsStyle
Стиль кнопки.Может оказаться сочетание значений, перечисленных ниже.Создает TBSTYLE_BUTTON стандартной кнопки.
TBSTYLE_CHECK создает кнопка, которая переключает между состоянием и нажмите клавишу unpressed каждый раз, когда пользователь щелкает его.Кнопка имеет другой цвет фона при ее в нажатом состоянии.
Создает кнопку TBSTYLE_CHECKGROUP проверить, что не нажаты пребывания в другой нажатые кнопки в группе.
TBSTYLE_GROUP создает кнопка, которая остается нажатой до тех пор, пока не будет нажата вторая кнопка в группе.
TBSTYLE_SEP создает разделитель, предоставляя маленький разрыв между группами кнопки.Кнопка, которая принадлежит этот стиль не получает входные данные пользователя.
dwData
Определенные пользователем данные.iString
Индекс, начинающийся с нуля строки, используемый в качестве метки кнопки, -1, если ни одна строка для данной кнопки.
Образ и/или строка индекс которой указывается заранее быть добавлено в список элемента управления " Панель инструментов с помощью AddBitmap, AddString или AddStrings.
Требования
Header: afxcmn.h