Siemens WinCC. Руководство по конфигурации. Том 1
Подождите немного. Документ загружается.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-85
C79000-G8276-C157-01
•
Посредством функции API PDLRTSetLink() у выбранно го объекта создается связь
с тегом. Первый параметр фу нкции API описывает режим адресации объекта.
Следующие три параметра задают названия экранной формы, объекта и свойства.
В следующем параметре указывается адрес переменной link, определяющей
устанавливаемую связь с тегом. Следу ющие два пар аметра не имеют отношения к
рассматриваемым процедурам. В последнем параметре указывается адрес
структу ры для анализа ошибок. Если при выполнении происх одит ошибка,
сообщение об этом выводится на печать.
Замечание:
Первые два примера этой главы относятся к полю ввода/вывода I/OField1 экранной
формы cc_9_example_10x.PDL. Первый пример изменяет положение объекта на
экранной форме, второй создает связь этого объекта с тегом. При смене экранной
формы все внесенные изменения утрачиваются. Проверьте, что после выполнения
всех функций CS, описываемых в последующих примерах, осуществляется смена
экранной формы. При этом изменения экранной формы, внесенные при помощи дву х
первых кнопок, будут утрачены при нажатии на одну из других кнопок.
Курс Си для WinCC 09.99
4-86
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.8.3 Пример 3 — Создание нового объекта при помощи
функций CS
В данном примере функции CS API графического редактора используются для
создания нового объекта I/O Field. Пример сконфигурирован для изображенной ниже
кнопки Button3 в окне свойств объекта в Event (Событие) Mouse (Мышь)
Mouse Action (Проце дура мыши).
Процедура Си, связанная с кнопкой Button3
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-87
C79000-G8276-C157-01
•
В первой части производится загрузка DLL API графического дизайнера. В
дополнение подключается заголовочный файл pdl_guid.h, содержащий описания
используемых в данном примере символьных констант.
•
Затем описывается строковая переменная szProjectName для размещения названия
проекта.
•
Далее описывается строковая переменная для размещения названия экранной
формы. Обратите внимание, что название экранной формы должно включать
расширение PDL (в отличие от RT).
•
После этого описываются дополнительные переменные. Среди них переменная
типа GUID, определяющая тип создаваемого объекта.
Курс Си для WinCC 09.99
4-88
Руководство по конфигурации WinCC
C79000-G8276-C157-01
• В следующей части название проекта определяется при помощи функции API
DMGetRuntimeProject(). Название проекта будет храниться в переменной
szProjectName. Если при определении названия проекта произойдет ошибка,
сообщение об этом будет выведено на печать. В этом слу чае процедура Си
завершается посредством ко манды return.
• В следующей части API графического дизайнера инициализируется при помощи
функции PDLCSGetOleAppPtr(). Если при инициализации API графического
дизайнера произойдет ошибка, сообщение об этом будет выведено на печать. В
этом случае процедура Си также завершается посредством команды return.
• В следующей части подлежащая редактированию экранная форма открывается
посредством функции API PDLCSOpenEx(). Предпоследним параметром в
функцию API передается переменная dwFlags, имеющая значение 1. При этом
экранная форма не отображается на экране. Если при открытии экранной формы
произойдет ошибка, сообщение об этом будет выведено на печать. При помощи
команды goto выполняется переход к фрагменту кода, где разрывается связь с API
графического дизайнера.
• В следующей части с помощью функции API PDLCSNewObjectEx() создается
объект I/OField2. Если при создании объекта произойдет ошибка, сообщение об
этом будет выведен о на печать. При помо щи команды goto выполняется переход к
фрагменту кода, где ранее открытая экранная форма закрывается.
• В следующей части экранная форма записывается посредством функции API
PDLCSSave(). Если при записи экранной формы произойдет ошибка, сообщение
об этом будет выведено на печать. Как и в предыдущей части, при помощи
команды goto выполняется переход к фрагменту кода, где ранее открытая
экранная форма закрывается.
• Затем редактируемая экранная форма выбирается функцией проекта
ActualizeObjects().
• Далее ранее открытая экранная форма закрывается с помощью функции API
PDLCSClose(). Перед этой командой установлена метка для описанных ранее
команд goto.
• После этого связь с API графического редактора вновь разрывается посредством
функции API PDLCSDelOleAppPtr().Перед этой командой установлена метка для
описанных ранее команд goto.
Замечание:
Процедуры Си, создаваемые в последующих примерах очень похожи на процедуру
Си, представленную здесь. В связи с этим мы будем опускать подробные описания,
приведенные в данном примере. Описания исходного кода будут ограничены
обзором хода выполнения программы.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-89
C79000-G8276-C157-01
4.8.4 Пример 4 — Изменение свойств при помощи функции
CS
В данном примере функции CS API графического дизайнера используются для
установки свойств изображенного объекта. Координаты объекта изменяются
заданием свойств Position X (Координата X) и Position Y (Координата Y). Пример
сконфигурирован для изображенной ниже кнопки Button4 в окне свойств объекта в
Event (Событие)
Mouse (Мышь) Mouse Action (Процедура мыши).
Процедура Си, связанная с кнопкой Button4
Курс Си для WinCC 09.99
4-90
Руководство по конфигурации WinCC
C79000-G8276-C157-01
• В первой части загружается DLL API графического дизайнера.
• Во второй час ти описываются необходимые переменные. Названия и значения
задаваемых свойств хранятся в массивах, в отличие от примера 1.
• Название проекта определяется при по мощи функции API DMGetRuntimeProject().
• API графиче ского дизайнера инициализируется функцией API
PDLCSGetOleAppPtr().
• Подлежащая редактированию экранная форма открывается при помощи функции
API PDLCSOpenEx().
• В цикле for с помощью функции API PDLCSSetPropertyEx() устанавливаются
свойства объекта. Если устанавливаемые таким образом свойства объекта имеют
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-91
C79000-G8276-C157-01
различные типы, то вместо переменной vt следу ет использовать массив. Этот
массив будет определять тип устанавливаемого свойства.
•
Экранная форма записывается посредством функции API PDLCSSave().
•
Редактируемая экранная форма открывается вновь с помощью функции проекта
ActualizeObjects().
•
Экранная форма вновь закрывается при помощи функции API PDLCSClose().
•
Связь с API графического дизайнера разрывается посредством функции API
PDLCSDelOleAppPtr().
Курс Си для WinCC 09.99
4-92
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.8.5 Пример 5 — Создание связи с тегом с помощью
функции CS
В данном примере функции CS API графического дизайнера используются для
создания связи с тегом. С тегом связывается свойство поля ввода/вывода, что
делается в меню Property (Свойство) Output/Input (Ввод/вывод) Output
Value (Выходное значение). При мер сконфигурирован для изображенной ниже
кнопки Button5 в окне свойств объекта в Event (Событие)
Mouse (Мышь)
Mouse Action (Проце дура мыши).
Процедура Си, связанная с кнопкой Button5
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-93
C79000-G8276-C157-01
•
В первой части загружается DLL API графического дизайнера.
•
Во второй час ти описываются необходимые переменные.
•
Название проекта определяется при по мощи функции API DMGetRuntimeProject().
•
API графиче ского дизайнера инициализируется функцией API
PDLCSGetOleAppPtr().
•
Подлежащая редактированию экранная форма открывается при помощи функции
API PDLCSOpenEx().
•
В следующей части в поля структу рной переменной link записываются данные об
устанавливаемой с тего м связи.
•
Связь с тегом создается при помощи фу нкции PDLCSSetLink().
Курс Си для WinCC 09.99
4-94
Руководство по конфигурации WinCC
C79000-G8276-C157-01
• Экранная форма записывается посредством функции API PDLCSSave().
• Редактируемая экранная форма открывается вновь с помощью функции проекта
ActualizeObjects().
• Экранная форма вновь закрывается при помощи функции API PDLCSClose().
• Связь с API графического дизайнера разрывается посредством функции API
PDLCSDelOleAppPtr().