CreateToolBar

CreateToolBar()

Синтаксис

Result = CreateToolBar(#ToolBar , WindowID [, Flags])

Описание

Создает новую пустую Панель инструментов (ToolBar) в данном окне.

Параметры

#ToolBar Номер, идентифицирующий новую Панель инструментов. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.

WindowID Идентификатор Окна, в котором должна быть создана Панель инструментов. Корректный идентификатор 'WindowID' можно получить с помощью функции WindowID().
Flags (дополн.)
Этот параметр может быть комбинацией следующих значение (с помощью оператора '|'):
  - #PB_ToolBar_Small     : Маленькая иконка (16x16 пикселей) панель инструментов (по умолчанию) 
  - #PB_ToolBar_Large     : Большая иконка (24х24 пикселя) панель инструментов
  - #PB_ToolBar_Text      : Текст будет отображаться под кнопкой
  - #PB_ToolBar_InlineText: Текст будет отображаться справа от кнопки (только для Windows)

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

Возвращает не нулевое значение, если Панель инструментов была создана успешно, в противном случае 0. Если в качестве параметра #ToolBar использовалось значение #PB_Any, то в случае успеха будет возвращен сгенерированный Номер.

Комментарии

Эта Панель инструментов становится панелью инструментов по умолчанию для создания элементов управления, и теперь можно добавлять в неё элементы с помощью функций ToolBarStandardButton(), ToolBarImageButton() и ToolBarSeparator().

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

Пример

If OpenWindow(0, 0, 0, 150, 25, "Панель инструментов", #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

См. также

ToolBarStandardButton(), ToolBarImageButton(), ToolBarSeparator(), FreeToolBar()

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

Все

Оглавление ToolBar - DisableToolBarButton() ->

#ToolBar	Номер, идентифицирующий новую Панель инструментов. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
WindowID	Идентификатор Окна, в котором должна быть создана Панель инструментов. Корректный идентификатор 'WindowID' можно получить с помощью функции WindowID().
Flags (дополн.)	Этот параметр может быть комбинацией следующих значение (с помощью оператора '\|'): - #PB_ToolBar_Small : Маленькая иконка (16x16 пикселей) панель инструментов (по умолчанию) - #PB_ToolBar_Large : Большая иконка (24х24 пикселя) панель инструментов - #PB_ToolBar_Text : Текст будет отображаться под кнопкой - #PB_ToolBar_InlineText: Текст будет отображаться справа от кнопки (только для Windows)