Проект gpl-2C

 

Документация\Уровень 0\Описание встроенного языка

Пред.

Содержание

След.
1.5.7 Модуль (Module)

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

1.5.9 СписокЗначений(ValueList)

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 до ПолучитьКоличество()  
Возвращаемое значение: номер картинки из библиотеки картинок.