ToolBarImageButton

ToolBarImageButton()

Синтаксис

ToolBarImageButton(#Button , ImageID [, Mode [, Text$]])

Описание

Добавляет Кнопку с изображением на создаваемую в данный момент Панель инструментов. Перед использованием этой функции должна быть вызвана функция CreateToolBar().

Параметры

#Button Номер, для идентификации новой Кнопки на текущей Панели инструментов.

ImageID Идентификатор изображения используемого для кнопки. Корректный идентификатор 'ImageID' можно получить с помощью функции ImageID(). Изображение может быть загружено с помощью функции LoadImage() или создано в памяти с помощью функции CreateImage(). Чтобы получить прозрачный фон, используйте формат файла 'значок' (.ico) в Windows, или формат файла PNG в Linux/MacOS X.
Mode (дополн.)
Режим работы кнопки. Это значение режима может быть одной из следующих констант:
  #PB_ToolBar_Normal: Кнопка будет действовать как стандартная кнопка (настройка по умолчанию).
  #PB_ToolBar_Toggle: Кнопка будет действовать как переключатель.
Чтобы получить или изменить состояние переключателя, используйте команды GetToolBarButtonState() и SetToolBarButtonState().
Text$ (дополн.) Текст отображаемый с этой кнопкой. Панель инструментов должна быть создана с флагом #PB_ToolBar_Text, иначе текст не будет отображаться.

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

Ничего.

Комментарии

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

Пример

If OpenWindow(0, 0, 0, 150, 25, "ToolBar", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
CreateImage(0, 16, 16)
StartDrawing(ImageOutput(0))
Box(0, 0, 16, 16, RGB(255, 255, 255))
Box(4, 4, 8, 8, RGB(255, 0, 0))
StopDrawing()
CreateImage(1, 16, 16)
StartDrawing(ImageOutput(1))
Box(0, 0, 16, 16, RGB(255, 0, 0))
Box(4, 4, 8, 8, RGB(255, 255, 255))
StopDrawing()
If CreateToolBar(0, WindowID(0))
ToolBarImageButton(0, ImageID(0))
ToolBarImageButton(1, ImageID(1))
EndIf
Repeat
Until WaitWindowEvent() = #PB_Event_CloseWindow
EndIf

См. также

CreateToolBar(), ToolBarStandardButton(), ToolBarSeparator()

Поддерживаемые OS

Все

<- ToolBarID() - Оглавление ToolBar - ToolBarSeparator()->

#Button	Номер, для идентификации новой Кнопки на текущей Панели инструментов.
ImageID	Идентификатор изображения используемого для кнопки. Корректный идентификатор 'ImageID' можно получить с помощью функции ImageID(). Изображение может быть загружено с помощью функции LoadImage() или создано в памяти с помощью функции CreateImage(). Чтобы получить прозрачный фон, используйте формат файла 'значок' (.ico) в Windows, или формат файла PNG в Linux/MacOS X.
Mode (дополн.)	Режим работы кнопки. Это значение режима может быть одной из следующих констант: #PB_ToolBar_Normal: Кнопка будет действовать как стандартная кнопка (настройка по умолчанию). #PB_ToolBar_Toggle: Кнопка будет действовать как переключатель. Чтобы получить или изменить состояние переключателя, используйте команды GetToolBarButtonState() и SetToolBarButtonState().
Text$ (дополн.)	Текст отображаемый с этой кнопкой. Панель инструментов должна быть создана с флагом #PB_ToolBar_Text, иначе текст не будет отображаться.