Свойства панели-ссылки могут быть изменены путем изменения исходной панели-источника. Данные изменения отслеживаются автоматически и глобально применяются ко всем панелям-ссылкам, ссылающимся на данную панель-источник. Для просмотра изменений необходимо перезагрузить панель, содержащую панель-ссылку.

Свойства панели-ссылки и объектов, входящих в состав панели-ссылки, могут быть также изменены индивидуально и без внесения изменений в панель-источник. Подобное изменение именуется «переопределением». Значения переопределенных параметров сохраняются в панели, на которой находится панель-ссылка.

В таблице ниже приведены термины, связанные с использованием ссылок.

Термин	Значение
$-параметр	Переменная для значений, которые должны передаваться в направлении панели-ссылки. Определение (декларирование) набора $-параметров производится в сценарии панели-источника. Значения $-параметров определяются в панелях, содержащих панели-ссылки. ВНИМАНИЕОпределение (декларирование) набора $-параметров производится в сценарии панели-источника. В панели, на которой присутствует панель-ссылка, могут быть определены значения только тех $-параметров, которые предварительно декларированы в сценарии панели-источника.
Ссылка, панель-ссылка, объект-ссылка	Графический объект, который используется в панели в качестве ссылки на панель-источник. Панели-источники необходимо сохранять в директории «panels/objects». Использование ссылок целесообразно при частом использовании одинаковых графических объектов. При изменении оригинальной панели-источника автоматически изменяются все используемые ссылки.  При декларировании $-параметра первый символ, расположенный непосредственно после знака доллара, интерпретируется в качестве типа данных. См. перечень типов данных ниже.
Панель-источник	Панель в директории «panels/objects». Панель используется в качестве источника в другой панели, т.е. в последней присутствует панель-ссылка, ссылающаяся на панель-источник.
Панель настройки, панель параметрирования	Панель, которая используется для настройки $-параметров.
Переопределение	Свойства ссылки и объектов, входящих в состав ссылки, могут быть изменены индивидуально без внесения изменений в панель-источник. Подобное изменение именуется «переопределением». Переопределение свойств выполняется в панели, на которой находится панель-ссылка. Переопределение полезно в случае частого использования ссылок, только некоторые из которых требуют изменений.

ВНИМАНИЕ

В переопределенный сценарий не могут быть добавлены новые $-параметры. Они не отображаются в редакторе свойств, в этой связи не могут быть заданы их значения. Данное правило действует также в отношении ссылки на переопределенную панель.

ВНИМАНИЕ

Для панелей-ссылок недоступны свойства «Видимый», «Разрешен» или «Цвет рисунка». В этой связи для управления, например, видимостью все панели-ссылки требуется переопределение соответствующих свойств отдельных объектов панели-ссылки. Пример:

1. Создается панель «panel_a». В панель добавляются кнопки, значение свойства «Видимый» которых равняется «FALSE».

2. Панель добавляется в качестве ссылки в другую панель «panel_b».

3. В панели «panel_b» для кнопок в панели-ссылке задаются (переопределяются) сценарии инициализации кнопок («PUSH_BUTTON1.visible=true;» и т.д.).

4. При открытии панели «panel_a» в режиме выполнения кнопки становятся видимыми.

ВНИМАНИЕ

При масштабировании ссылки также масштабируются контуры объектов внутри ссылки.

Далее описаны процесс переопределения (изменения свойств панелей-ссылок и входящих в их состав объектов), процесс добавления ссылок и т.д.

ПРОЦЕСС ИЗМЕНЕНИЯ СВОЙСТВ ССЫЛОК ПУТЕМ ИЗМЕНЕНИЯ ПАНЕЛИ-ИСТОЧНИКА
 

1. В графическом редакторе откройте панель-источник, содержащую некоторые объекты.
2. Измените свойство одного из объектов (например, цвет) при помощи Редактора свойств (вкладка «Стандартные«).
3. Сохраните панель-источник (меню «Панель» -> «Сохранить панель«).

Все ссылки (на измененную панель-источник), используемые в других панелях, будут изменены автоматически. Повторная вставка объектов не требуется.

ДОБАВЛЕНИЕ ПАНЕЛИ В КАТАЛОГ ОБЪЕКТОВ ПРОЕКТА
 

1. Добавьте несколько объектов на панель.
2. Сохраните данную панель в поддиректории проекта «panels/objects«.
3. В меню «Вид» выберите «Каталоги -> [имя проекта]«. Новая панель будет отображена в каталоге объектов проекта.

ПЕРЕОПРЕДЕЛЕНИЕ ССЫЛКИ
 

Под «переопределением» понимается индивидуальное (и выполняемое без внесения изменений в панель-источник) изменение свойств отдельной панели-ссылки и объектов, входящих в состав панели-ссылки. Переопределение свойств выполняется в панели, на которой находится панель-ссылка. Свойства ссылки отображаются в Редакторе свойств. Изменяемые свойства ссылки отображаются на вкладке «Стандартные» Редактора свойств. Неразрешенные (disabled) свойства не могут быть переопределены. Свойства, маркированные синим фоном, уже переопределены.
 

1. Выберите добавленную на панель панель-ссылку и выберите элемент «Выбор Объекта/Группы» меню «Вид«.
2. Для отображения в открывшемся окне выбора объекта/группы тех графических объектов, которые входят в состав панелей-ссылок, установите флажок «Показать объекты в панелях-ссылках«.
3. После установки флажка объекты панелей-ссылок отображаются в окне «Выбор Объекта/Группы» (см. рисунок ниже). Выберите графические объекты, свойства которых необходимо переопределить. Выпадающий список в верхней части окна позволяет выполнить фильтрацию графических объектов по типу. Фильтрация графических объектов по типам, именам объектов или именам групп может быть выполнена при помощи текстовых полей.

Рисунок: Выбор Объекта/Группы

4. Редактируемые свойства выбранного объекта (например, текст или цвет) могут быть изменены во вкладке «Стандартные» Редактора свойств. Также имеется возможность, например, увеличить или уменьшить размер объекта или повернуть его. При выборе панели-ссылки, цвет рамок (границ)объектов с переопределенными свойствами изменяется на малиновым.
5. Сохраните панель.

ПРИМЕЧАНИЕ

При переопределении только части ссылки (например, изменен только размер простого объекта в пределах ссылки) положение реперной точки панели-ссылки не изменяется. В случае перемещения панели-ссылки положение реперной точки относительно панели-ссылки также не изменяется.

Изменение порядка перекрытия объектов (при помощи опций «На передний план» или «На задний план«) в пределах ссылки с использованием переопределения не сохраняется.

ВНИМАНИЕ

В случае выбора объекта (в составе панели-ссылки) в области «Объекты» окна «Выбор Объекта/Группы» (см. выше) активируется режим «Выбор объекта на панели-ссылке». Свойства выбранного объекта отображаются в Редакторе свойств — см. второе изображение ниже. Полностью панель-ссылка может быть выбрана в области «Группы» (см. выше). В случае выбора объекта в пределах панели-ссылки для данного объекта отображается обрамляющий прямоугольник с узлами малинового цвета (см. второе изображение ниже). Для отображения объектов, входящих в состав панелей-ссылок, необходимо установить флажок «Показать объекты в панелях-ссылках». Отображение всех графических объектов только одной определенной группы ссылок невозможно.

ПРИМЕЧАНИЕ

При установке флажка «Показать объекты в панелях-ссылках» кнопка «Удалить объект» деактивируется. Выбранная панель-ссылка может быть удалена при помощи клавиши клавиатуры Удалить (Delete). Удаление отдельных объектов, входящих в состав панели-ссылки, при помощи клавиши Удалить (Delete) невозможно.

Рисунок: Свойства панели-ссылки, созданной на основе панели-источника «TrafficLights.pnl»

Рисунок: Свойства элемента «Ellipse1» панели-ссылки

ПАНЕЛИ-ССЫЛКИ С $-ПАРАМЕТРАМИ

$-параметры позволяют передавать значения в панели и являются аналогами аргументов функции (при вызове функций аргументам присваиваются конкретные значения). $-параметры (например, «$valve«) декларируются в панели-источнике. При добавлении панели-ссылки на панель каждому $-параметру может быть присвоено требуемое значение, например, точка данных, строка управления цветом или имя файла панели.

Пример: При помощи $-параметра «$valve» в панель-ссылку «valve12» передается имя точки данных «valve12».

Для выбора точек данных, файлов и цветов доступно удобное в использовании окно.

ПРИМЕЧАНИЕ

Рекомендуется назначать $-параметрам имена, которые предопределяют тип данных. Подобный подход упрощает работу с $-параметрами и повышает прозрачность решения. Синтаксис $-параметров описан в разделе «Параметры«, входящем в раздел «Введение в язык сценариев CTRL» Справки по «КАСКАД Цифра».

ДОБАВЛЕНИЕ ПАНЕЛИ-ССЫЛКИ С $-ПАРАМЕТРАМИ
 

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

Рисунок: Стандартная панель «Определение параметров ссылок»

Стандартная панель «Определение параметров ссылок» содержит

• имя файла текущей панели-источника,
• имя ссылки,
• таблицу с $-параметрами панели-источника и значениями данных $-параметров
• На снимке экрана ниже показан заголовок таблицы (снимок экрана и номера столбцов в описании ниже относятся к предыдущей версии).

Рисунок: Заголовок таблицы

• в первом столбце приведен перечень $-параметров панели-источника.
• во втором столбце приведены типы данных каждого из $-параметров.

При декларировании $-параметра первый символ, расположенный непосредственно после знака доллара, интерпретируется в качестве типа данных.

1. Символ после знака доллараТип данных$bBool$cChar$fFloat$iInt$sString$uUnsigned

В следующих трех столбцах расположены кнопки для открытия окон, при помощи которых осуществляется выбор точек данных, файлов или цветов.

1. ЗначокНазначениеОткрывает селектор точек данных.Открывает селектор файлов (панелей).Открывает панель выбора цвета.

В последнем столбце «Значение» отображается выбранное значение. Значение может быть также введено непосредственно в данном столбце.

Создание собственных панелей настройки

Вместо использования стандартной панели настройки $-параметров для панелей-ссылок имеется возможность использования собственных панелей настройки. Панель «подключается» в качестве панели настройки путем ввода имени панели в поле свойства «Файл настройки ссылок» панели-источника, например, «para/refpanel.pnl».

ИЗМЕНЕНИЕ ЗНАЧЕНИЯ $-ПАРАМЕТРА В СУЩЕСТВУЮЩЕЙ ПАНЕЛИ-ССЫЛКЕ
 

Имеется возможность просмотра и редактирования значений $-параметров панели-ссылки. Для этого используется свойство «$-параметры» на вкладке «Стандартные» Редактора свойств. При щелчке левой кнопкой мыши по данному свойству открывается стандартная панель «Определение параметров ссылок» (см. соответствующий рисунок выше).

Рисунок: Вкладка «Стандартные» существующей панели-ссылки с несколькими $-параметрами

УДАЛЕНИЕ ПЕРЕОПРЕДЕЛЕНИЯ СВОЙСТВА

Для удаления переопределения свойства необходимо в редакторе свойств щелкнуть правой кнопкой мыши по полю свойства с синим фоном и выбрать в открывшемся контекстном меню опцию «Удалить переопределение«.

Переопределение следующих свойств невозможно:

• (относится к предыдущей версии) Положение (x и y)
• Слои
• Также невозможно переопределение состава (списка) элементов Переключателей, Селекторов, Выпадающих списков и Списков выбора. Порядок следования элементов данных объектов также не может быть переопределен.
• (относится к предыдущей версии) В том случае, если одновременно выбрано несколько объектов, входящих в состав различных панелей-ссылок, то переопределение объектов невозможно.

Отсутствие панелей-источников

При открытии панели выполняется проверка на предмет существования панелей-источников для включенных в открываемую панель панелей-ссылок. В случае отсутствия одной или нескольких панелей-источников открывается диалоговое окно выбора файлов для выбора нового пути файла панели-источника или для выбора альтернативного файла (альтернативной панели-источника).

ПРИМЕЧАНИЕ

В нижней части редактора GEDI отображается информация об отсутствующей панели-источнике, см. рисунок ниже.

Рисунок: Отсутствующая панель-источник

В интерфейсе пользователя отсутствующая панель-источник отображается следующим образом:

Рисунок: Отсутствующая панель-источник

ВНИМАНИЕ

В случае выбора альтернативной панели-источника проверка на предмет соответствия $-параметров в новой панели-источнике и в существующих панелях-ссылках не выполняется! Подобную проверку необходимо проводить вручную!