Функция предназначена для открытия панели алармов и событий в указанной позиции и обеспечивает печать верхней таблицы панели алармов и событий, а также сохранение содержимого данной таблицы.
Синтаксис
int openAES(string screenConfig, string module, int action, [string fileName], int xPos, int yPos);
Параметр
Параметр | Описание |
screenConfig | Имя конфигурации AES (панели алармов и событий). Указываемое имя конфигурации AES должно соответствовать одной из конфигураций (например, «aes_default»), доступных в выпадающем списке «конфигурации AES» на панели настройки AES. Допускается использование пользовательских конфигураций. |
module | Имя модуля, в котором должна открываться панель алармов и событий. Значение по умолчанию: «»КАСКАД Цифра» AES». Значение по умолчанию «»КАСКАД Цифра» AES» используется в том случае, если желаемое имя модуля не указано явно.При указании вместо имени модуля значения «TRUE» панель алармов и событий будет отображаться поверх остальных окон. При указании вместо имени модуля значения «FALSE» панель алармов и событий может перекрываться другими окнами. В том случае, если имя модуля указано явно, используется имя модуля. openAES(«aes_default») // Открытие панели в соответствии с настройкамиopenAES(«aes_default», TRUE) // Открытие панели поверх остальных оконopenAES(«aes_default», FALSE) // Открытие панели с возможностью перекрытия другими окнамиopenAES(«aes_default», «HUGO») // Открытие панели в соответствии с настройками в модуле «HUGO» |
action | Требуемое действие. Действие задается при помощи константы. Допустимые константы:const int AES_ACTION_INTERACT = 0; // Режим по умолчаниюconst int AES_ACTION_AUTORUN = 1; // Открытие панели алармов и событий с запуском [обновления информации в таблицах]const int AES_ACTION_PRINT = 2; // Вывод на печать верхней таблицы панели алармов и событий. Вывод таблицы на печать допускается только в режиме закрытого временного интервала. В связи с этим, при необходимости печати верхней таблицы, в панели настройки таблицы для верхней таблицы должен быть выбран закрытый временной интервал, при этом данная конфигурация таблицы должна быть сохранена. Затем конфигурация таблицы должна быть включена в конфигурацию AES (панель настройки AES, вкладка «Общие настройки AES», выпадающий список «Конфигурация таблицы» для верхней таблицы).const int AES_ACTION_SAVE = 3; // Сохранение содержимого панели алармов и событий Константы расположены в файле <путь_КАСКАД>/scripts/libs/aes.ctl |
fileName | Имя файла, выводимого на печать. Должен использоваться относительный путь. Файлы, сохраняемые с помощью панели алармов и событий (и которые могут быть выведены на печать), находятся в директории <путь_проекта>/data. |
xPos | Позиция панели по оси «x», например, 200. openAES(screenConfig, module, action,» «,200,100 ) |
yPos | Позиция панели по оси «y», например, 100 openAES(screenConfig, module, action,» «,200,100 ) |
Возвращаемое значение
В случае успешного выполнения функции возвращается 0, в случае возникновения ошибок (если конфигурация не обнаружена) возвращается -1.
Ошибки
Не найдена конфигурация.
Описание
Функция предназначена для открытия панели алармов и событий.
ПРИМЕР
В примере ниже представлено открытие панели алармов и событий.
main() { string screenConfig, module, fileName; int action = AES_ACTION_PRINT; // Печать таблицы screenConfig = «config»; /* Конфигурация AES согласно панели настройки AES */ module = «Vision_2»; /* Имя модуля, в котором должна быть открыта панель алармов и событий */ fileName = «table1»; /* Имя файла, который должен быть направлен на печать. Файлы, которые были сохранены (и могут быть напечатаны) с использованием панели алармов и событий, расположены в директории <путь_проекта>/data */ openAES(screenConfig, module, action, fileName); DebugN(«Функция была выполнена успешно»); } |
Принадлежность
Панель алармов и событий, обработка алармов
Область доступности
CTRL
См. также