Класс CToolBar

Статья
06/10/2015

Панель элементов управления, имеющих строку bitmapped кнопок и разделителей необязательно.

class CToolBar : public CControlBar

Члены

Открытые конструкторы

Имя	Описание
CToolBar::CToolBar	Создает объект CToolBar.

Открытые методы

Имя	Описание
CToolBar::CommandToIndex	Возвращает индекс кнопки с заданным идентификатором команды
CToolBar::Create	Создает панель инструментов Windows и вложение его к объекту CToolBar.
CToolBar::CreateEx	Создает объект CToolBar с помощью дополнительных стилей для внедренного объекта CToolBarCtrl.
CToolBar::GetButtonInfo	Извлекает идентификатор, стиль и номер образа кнопки.
CToolBar::GetButtonStyle	Извлекает стиль кнопки.
CToolBar::GetButtonText	Извлекает текст, который будет отображаться на кнопку.
CToolBar::GetItemID	Возвращает идентификатор команды кнопки или разделителя по заданному индексу.
CToolBar::GetItemRect	Возвращает прямоугольник для элемента по указанному индексу.
CToolBar::GetToolBarCtrl	Обеспечивает прямой доступ к общему элементу управления.
CToolBar::LoadBitmap	Загружает растровое изображение, содержащий растровое изображение- изображений кнопок.
CToolBar::LoadToolBar	Загружает созданный ресурс панели инструментов с редактором ресурсов.
CToolBar::SetBitmap	Задает bitmapped образа.
CToolBar::SetButtonInfo	Устанавливает идентификатор, стиль и номер образа кнопки.
CToolBar::SetButtons	Наборы застегивают стили и индекс изображений кнопок в растровое изображение.
CToolBar::SetButtonStyle	Задает стиль кнопки.
CToolBar::SetButtonText	Задает текст, который будет отображаться на кнопку.
CToolBar::SetHeight	Задает высоту панели инструментов.
CToolBar::SetSizes	Устанавливает размеры кнопок и их растровых изображений.

Заметки

Кнопки могут действовать как кнопки, кнопки "флажок" или переключатели. Объекты CToolBar обычно внедренные элементы объектов фреймового окна, производных от класса CFrameWnd или CMDIFrameWnd.

CToolBar::GetToolBarCtrl, функция-член новый с MFC 4.0 позволяет воспользоваться преимуществами поддержки управления Windows общим для настройки панели инструментов и дополнительными функциональными возможностями. Функции-члены необходимо CToolBar дают большую часть возможностей управления Windows общих; однако при вызове GetToolBarCtrl, можно предоставить пользовательским панель инструментов, даже несколько характеристик Windows 95 /98 панелей инструментов. При вызове GetToolBarCtrl, он возвращает ссылку на объект CToolBarCtrl. См. раздел CToolBarCtrl дополнительные сведения о конструировании панели инструментов с помощью управления Windows общие. Общие сведения о стандартных элементах управления см. в разделе общие элементы управления в Windows SDK.

Visual C++ предусмотрено 2 методами, чтобы создать панель инструментов. Создание ресурса панели инструментов с помощью редактора ресурсов, выполните следующие действия:

Создание ресурса панели инструментов.
Создайте объект CToolBar.
Вызовите функцию Создание (или CreateEx), чтобы создать панель инструментов Windows и вложить его к объекту CToolBar.
Вызов LoadToolBar для загрузки ресурса панели инструментов.

В противном случае, выполните следующие шаги:

Создайте объект CToolBar.
Вызовите функцию Создание (или CreateEx), чтобы создать панель инструментов Windows и вложить его к объекту CToolBar.
Вызовите LoadBitmap для загрузки растровое изображение, содержащее изображений кнопок панели инструментов.
Вызовите SetButtons для задания стиля кнопки и связать каждую кнопку с образом в растровом изображении.

Все изображений кнопок на панели инструментов берутся из одного растрового изображения, которое должно содержать один способ для каждой кнопки. Все образы должны быть одинаковым размером; значение по умолчанию - 16 пикселей по ширине и 15 пикселей высокого уровня. Образы должны параллельно в растровом изображении.

Функция SetButtons принимает указатель на массив идентификаторов элементов управления и целое число, определяющее количество элементов в массиве. Функция задает идентификатор каждой кнопки со значением соответствующего элемента массива и присвоит каждой кнопке индекс образа, который определяет положение изображения кнопок в растровом изображении. Если элемент массива имеет значение ID_SEPARATOR, индекс образа не присвоено.

Порядок изображений в растровом изображении обычно порядок, в котором они нарисована на экране, но можно использовать функцию SetButtonInfo для изменения связи между заказом образа и порядком вывода.

Все кнопки на панели инструментов имеют одинаковый размер. Значение по умолчанию - 24 x 22 точки, в соответствии с рекомендациям интерфейса Windows for software design. Любое дополнительное пространство между образ и измерения кнопки используется для формирования границу вокруг изображения.

Каждая кнопка имеет один способ. Различные состояния и стили (нажатые кнопки вверх, вниз, заблокированных, заблокированных, вниз и непредвиденный) формируются из одного образа. Хотя растровые изображения могут быть любые цветом, можно достигнуть лучших результатов с образами черным цветом и затенениях серого.

Предупреждение

CToolBar поддерживает растровые изображения с максимальным значением 16.При загрузке способ редактор панелей инструментов, Visual Studio автоматически преобразует образ в растровое изображение 16 цветов, если необходимый и отображает предупреждение, если образ был преобразован.При использовании образ с более 16 цветов (использование внешнего редактор для редактирования образ), то приложение может повести себя, как ожидается.

Кнопки панели инструментов имитируют по умолчанию кнопок. Однако кнопки панели инструментов также могут имитировать кнопки или переключатели флажка. Флажок кнопки имеют 3 состояний: проверяемый, очищенный и непредвиденный. Переключатели 2 имеют только состояния: проверяемый и очищенный.

Задать отдельный стиль кнопки или разделителя без указывать на массив, вызов GetButtonStyle для получения стиль, а затем вызвать SetButtonStyle вместо SetButtons. SetButtonStyle наиболее полезен, когда нужно изменить стиль кнопки во время выполнения.

Присвоение текста, чтобы появиться на кнопку вызвать GetButtonText для получения текста для отображения на кнопку, и затем вызывать SetButtonText для задания текста.

Для создания кнопки флажка, присвойте ей стиль TBBS_CHECKBOX или используйте функции-члена SetCheck объекта CCmdUI в обработчике ON_UPDATE_COMMAND_UI. Вызов SetCheck включает кнопку в кнопку. Передайте SetCheck аргумент равен 0, непроверенного, 1 или 2 для установленного флажка для неопределенного.

Для создания переключатель, вызовите функцию-член SetRadio объекта CCmdUI из обработчика ON_UPDATE_COMMAND_UI. Передайте SetRadio аргумент равен 0, непроверенного или ненулевого для установленного флажка. Предоставить группу радио взаимно исключающая - функциональности, необходимо иметь обработчики ON_UPDATE_COMMAND_UI для всех кнопок в группе.

Дополнительные сведения об использовании CToolBar см. в статье реализация панели инструментов MFC и Техническая примечание 31. Панель элементов управления.