1.5.8. Объект ПанельИнструментов (ToolBar)

Объект ПанельИнструментов позволяет программным путем создавать дополнительные панели инструментов главного окна и получать доступ к уже созданным панелям инструментов:

-главной панели;

-панели редактора форм конфигуратора;

-панели редактора модулей конфигуратора; 

1.5.8.1. Методы.

ПолучитьКоличество(), CountItem

Назначение: получить количество элементов в панели инструментов

Параметры: нет
Возвращаемое значение: числовое значение - количество элементов.

Добавить(<НомКартинки>,<ИмяФункции>,<ПараметрФункции>,<Текст>,<Подсказка>,<СтрокаСост>), Add

Назначение: добавление нового элемента, если номер картинки = 0, то добавляется разделитель

Параметры: 

<НомКартинки> - номер картинки из стандартной библиотеки картинок (см. обработку БиблиотекаКартинок)
<ИмяФункции> - имя функции текущего модуля или имя формы
<ПараметрФункции> - произвольный параметр для вышеуказанной функции
<Текст> - надпись кнопки (необязательный параметр)
<Подсказка> - текст, появляющийся в виде всплывающей подсказки
Возвращаемое значение: нет.
Пример:
глПанельСервиса=СоздатьОбъект("ПанельИнструментов");
глПанельСервиса.ИмяПанели("Сервис");
глПанельСервиса.Добавить(87 ,"СписокОтчетов",0,"","Список отчетов","Открыть список отчетов конфигурации...");
глПанельСервиса.Добавить(88 ,"СписокОбработок",0,"","Список обработок","Открыть список обработок конфигурации...");
глПанельСервиса.Добавить(340,СоздатьОбъект("БазаДанных"),"ВыбратьСоединение","",

                                                  "Подключение к БД","Открыть форму настройки подключения к БД...");
глПанельСервиса.Добавить(343 ,"SQL-Сервис",0,"","SQL-Сервис","Создание и исполнение SQL команд...");

Удалить(<Индекс>), Remove

Назначение: удаление элемента панели инструментов

Параметры: <Индекс> - число в диапазоне от 1 до ПолучитьКоличество()
Возвращаемое значение: нет.

Видимость(<Флаг>), Visible

Назначение: Показать/спрятать окно панели инструментов

Параметры: <Флаг> - число 1 - показать, число 0 - спрятать 
Возвращаемое значение: нет.

ПолучитьГлавнуюПанель(), GetMainTool

Назначение: Получить ссылку на агрегатный объект ПанельИнструментов, работающий со встроенной панелью инструментов

Параметры: нет 
Возвращаемое значение: ссылка на панель инструментов.

Пример:
Панель=СоздатьОбъект("ПанельИнструментов");
Панель.ПолучитьГлавнуюПанель().Видимость(0);

ПолучитьПанельФормы(), GetFormTool

Назначение: Получить ссылку на агрегатный объект ПанельИнструментов, работающий со встроенной панелью инструментов редактора форм

Параметры: нет 
Возвращаемое значение: ссылка на панель инструментов.

Пример:
Панель=СоздатьОбъект("ПанельИнструментов");
Панель.ПолучитьПанельФормы().Видимость(0);

ПолучитьПанельМодуля(), GetModuleTool

Назначение: Получить ссылку на агрегатный объект ПанельИнструментов, работающий со встроенной панелью инструментов редактора модулей

Параметры: нет 
Возвращаемое значение: ссылка на панель инструментов.

Пример:
Панель=СоздатьОбъект("ПанельИнструментов");
Панель.ПолучитьПанельМодуля().Видимость(0);

ИмяПанели(<Имя>), ToolName

Назначение: Задание/определение имени панели, для задания имени метод следует использовать до метода Добавить()

Параметры: <Имя> - новое имя панели  
Возвращаемое значение: имя панели до исполнения метода.

Пример:
Панель=СоздатьОбъект("ПанельИнструментов");
Главная=Панель.ПолучитьГлавнуюПанель();
Сообщить(Главная.ИмяПанели());

ПолучитьКартинку(<Индекс>), GetImage

Назначение: возвращает номер картинки элемента панели инструментов с индексом Индекс

Параметры: <Индекс> - число в диапазоне от 1 до ПолучитьКоличество()  
Возвращаемое значение: номер картинки из библиотеки картинок.