Поделиться через


CToolBar::SetButtonInfo

Эта функция-член вызывается с целью определения идентификатора команды кнопки, стиль и номер образа.

void SetButtonInfo( 
   int nIndex, 
   UINT nID, 
   UINT nStyle, 
   int iImage  
);

Параметры

  • nIndex
    Индекс, начинающийся с нуля кнопки или разделителя, для которой сведения быть задано.

  • nID
    Значение, с которым установлено идентификатор команды кнопки.

  • nStyle
    Новый стиль кнопки. Кнопки поддерживаются следующие стили:

    • Кнопка TBBS_BUTTON стандартная (по умолчанию)

    • Разделитель TBBS_SEPARATOR

    • Кнопка "флажок"TBBS_CHECKBOX автоматическая

    • TBBS_GROUP Отмечает начало группы в составе кнопки

    • TBBS_CHECKGROUP Отмечает начало группы в составе кнопки "флажок"

    • TBBS_DROPDOWN Создает кнопку раскрывающегося списка.

    • TBBS_AUTOSIZE Ширина кнопки будет рассчитывается на основе текста кнопки, а не на размер образа.

    • TBBS_NOPREFIX Текст кнопки не будет иметь префикс сочетаний клавиш, связанного с ним.

  • iImage
    Новый индекс для образа кнопки в растровое изображение.

Заметки

Для разделителей, имеющих стиль TBBS_SEPARATOR задает ширину разделителя в пикселях этой функции к значению, хранящихся в iImage.

Примечание

Также можно задать с помощью параметра состояния кнопки nStyle; однако, поскольку состояния кнопки выполняется обработчиком ON_UPDATE_COMMAND_UI любые состояния, которые устанавливаются с помощью SetButtonInfo будет потеряна во время следующего обработки бездействия.См. раздел Как объекты обновления интерфейса пользователя и TN031: Панель элементов управления дополнительные сведения.

Дополнительные сведения о кнопках образов и растрового изображения см. в обзоре CToolBar и CToolBar::LoadBitmap.

Требования

Header: afxext.h

См. также

Ссылки

Класс CToolBar

Диаграмма иерархии

CToolBar::GetButtonInfo