Скрипты Simple-Scada

Синтаксис

function GetTemplateObject(AName: string): TM_Object;

Важно! Данная функция работает только в скриптах объектов, которые находятся в шаблоне/шаблонном окне. Примеры использования функции можно найти по ссылке.

Описание

Возвращает объект с указанным именем из шаблона/шаблонного окна. Возвращает nil если объект не найден. Также, функция работает по событию OnInit шаблона/шаблонного окна и по событиям OnShow и OnClose шаблонного окна. Функция позволяет обращаться к объектам шаблона и работать с ними через скрипты.

Пример кода

Рассмотрим ситуацию, когда имеется шаблон с компонентами Кнопка (Button1) и Изображение (Image1) и требуется по нажатию на кнопку менять видимость изображения. Но к объектам внутри шаблона/шаблонного окна нельзя обратиться напрямую через скрипты, т.к. шаблон и объекты в нем не являются реальными объектами. Только после запуска проекта, на основе шаблона будет создано множество реальных объектов. А на основе шаблонных окон будет создано множество реальных окон. До запуска проекта эти объекты не существуют.

Функция GetTemplateObject решает проблему обращения к объектам шаблона. Для решения вышеописанной задачи на событие OnClick кнопки нужно назначить следующий код:

var
  aImage: TM_Image;
begin
  // ищем среди всех объектов шаблона объект с именем Image1 и 
  // записываем результат в локальную переменную aImage
  aImage := GetTemplateObject('Image1') as TM_Image;
 
  // теперь работаем с полученным изображением меняя его 
  // видимость на противоположное значение 
  aImage.Visible := not aImage.Visible;
end.