ToolBarStandardButton

ToolBarStandardButton()

Синтаксис

ToolBarStandardButton(#Button , #ButtonIcon [, Mode [, Text$]])

Описание

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

Параметры

#Button Номер, для идентификации новой Кнопки на текущей Панели инструментов.
#ButtonIcon
Этот параметр может быть одной из следующих констант:
  #PB_ToolBarIcon_New
  #PB_ToolBarIcon_Open
  #PB_ToolBarIcon_Save
  #PB_ToolBarIcon_Print
  #PB_ToolBarIcon_PrintPreview
  #PB_ToolBarIcon_Find
  #PB_ToolBarIcon_Replace

  #PB_ToolBarIcon_Cut
  #PB_ToolBarIcon_Copy
  #PB_ToolBarIcon_Paste
  #PB_ToolBarIcon_Undo
  #PB_ToolBarIcon_Redo

  #PB_ToolBarIcon_Delete
  #PB_ToolBarIcon_Properties
  #PB_ToolBarIcon_Help
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)
If CreateToolBar(0, WindowID(0))
ToolBarStandardButton(0, #PB_ToolBarIcon_New)
ToolBarStandardButton(1, #PB_ToolBarIcon_Open)
ToolBarStandardButton(2, #PB_ToolBarIcon_Save)
EndIf
Repeat
Event = WaitWindowEvent()
If Event = #PB_Event_Menu
Debug "Идентификатор Панели инструментов: "+Str(EventMenu())
EndIf
Until Event = #PB_Event_CloseWindow
EndIf

См. также

CreateToolBar(), ToolBarImageButton(), ToolBarSeparator()

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

Windows, Linux

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

#Button	Номер, для идентификации новой Кнопки на текущей Панели инструментов.
#ButtonIcon	Этот параметр может быть одной из следующих констант: #PB_ToolBarIcon_New #PB_ToolBarIcon_Open #PB_ToolBarIcon_Save #PB_ToolBarIcon_Print #PB_ToolBarIcon_PrintPreview #PB_ToolBarIcon_Find #PB_ToolBarIcon_Replace #PB_ToolBarIcon_Cut #PB_ToolBarIcon_Copy #PB_ToolBarIcon_Paste #PB_ToolBarIcon_Undo #PB_ToolBarIcon_Redo #PB_ToolBarIcon_Delete #PB_ToolBarIcon_Properties #PB_ToolBarIcon_Help
Mode (дополн.)	Режим работы кнопки. Это значение режима может быть одной из следующих констант: #PB_ToolBar_Normal: Кнопка будет действовать как стандартная кнопка (настройка по умолчанию). #PB_ToolBar_Toggle: Кнопка будет действовать как переключатель. Чтобы получить или изменить состояние переключателя, используйте команды GetToolBarButtonState() и SetToolBarButtonState().
Text$ (дополн.)	Текст отображаемый с этой кнопкой. Панель инструментов должна быть создана с флагом #PB_ToolBar_Text, иначе текст не будет отображаться.