Siemens WinCC. Руководство по конфигурации. Том 1
Подождите немного. Документ загружается.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-95
C79000-G8276-C157-01
4.8.6 Пример 6 — Перечисление объектов с помощью
функции CS
В данном примере функции CS API графического редактора используются для
перечисления объектов, размещенных на отображаемой экранной форме. Для
каждого имеющегося объекта API вызовет специально созданную функцию, которой
передаст в качестве параметров данные о теку ще м объекте. Такая фу нкция
называется функцией обратного вызова (Callback). При мер сконфигурирован для
изображенной ниже кнопки Button6 в окне свойств объекта в Event (Событие)
Mouse (Мышь) Mouse Action (Процедура мыши).
Функция проекта ObjectCallback()
•
В первой части включается заголовочный файл pdlcsapi.h, содержащий
определение структур ного типа OBJECT_INFO_STRUCT.
•
Тип возвращаемого значения, а также количество и типы аргументов данно й
функции можно узнать из WinCC ODK.
•
Затем описывается указатель, ссылающийся на структурную переменную типа
OBJECT_INFO_STRUCT. Этой переменной присваивается адрес, переданный в
первом аргументе. Производится проверка этого указателя.
•
Название объекта, полу ченного в OBJECT_INFO_STRUCT выводится на печать.
Курс Си для WinCC 09.99
4-96
Руководство по конфигурации WinCC
C79000-G8276-C157-01
Процедура Си, связанная с кнопкой Button6
• В первой части загружается DLL API графического дизайнера.
• Во второй час ти описываются необходимые переменные.
• Название проекта определяется при по мощи функции API DMGetRuntimeProject().
• API графиче ского дизайнера инициализируется функцией API
PDLCSGetOleAppPtr().
• Подлежащая редактированию экранная форма открывается при помощи функции
API PDLCSOpenEx().
• Функция API PDLCSEnumObjList() перечисляет все объекты экранной формы.
Для этого ей передается адрес предварительно созданной функции проекта
ObjectCallback(). Такая фу нкция называется фу нкцией обратного вызова. Она
вызывается по одному разу для каждого объекта экранной формы и получает
данные об этом объекте в качестве передаваемых аргументов.
• Экранная форма записывается посредством функции API PDLCSSave().
• Редактируемая экранная форма открывается с помощью функции проекта
ActualizeObjects().
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-97
C79000-G8276-C157-01
•
Экранная форма закрывается при помощи функции API PDLCSClose().
•
Связь с API графического дизайнера разрывается посредством функции API
PDLCSDelOleAppPtr().
Вывод в окне диагностики
Пример, описываемый в данной главе, осуществляет в окне диагностики вывод
следующего текста:
Курс Си для WinCC 09.99
4-98
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.9 Среда проекта
В проекте WinCC Project_C_Course примеры, относящиеся к среде проекта, можно
открыть, щелкнув на изображенну ю ниже пиктограмму навигационной панели.
Примеры находятся на экранной форме, назы вающейся cc_9_example_11.PDL.
Общие сведения
Зачастую при программировании процедур Си или других функций необходимо
указывать путь к файлу, название локального компьютера и т.п. Данные параметры
можно задать как абсолютные значения в соответствии с текущей конфигурацией.
Это может вызвать проблемы при переносе про екта на другой компьютер.
Конфигурация другого компьютера с большой степенью вероятности отличается от
конфигу рации того компьютера, на котором создавался проект. В связи с этим
рекомендуется воздерживаться от использования каких–либо параметров,
привязанных к конкретной конфигурации. Вместо этого все подобные данные
следует определять во время исполнения. В данной главе приводятся примеры,
иллюстрирующие возможности доступа к конфигурации локального компьютера.
Для этого использу ются как WinCC API, так и Windows API.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-99
C79000-G8276-C157-01
4.9.1 Пример 1 — Определение файла проекта
В данном примере описывается процедура определения файла проекта WinCC.
Пример сконфигурирован для изображенной ниже кнопки Button1 в окне свойств
объекта в Event (Событие)
Mouse (Мышь) Mouse Action (Процедура
мыши).
Процедура Си, связанная с кнопкой Button1
•
В первой части описывается переменная bRet типа BOOL.
•
Затем описывается строковая переменная szProjectFile для размещения названия
файла про екта. Размер этой переменной определяется максимальной возможной
длинной описания пути к файлу.
•
Далее описывается переменная типа CMN_ERROR.
•
После этого название проекта определяется при помощи функции API
DMGetRuntimeProject(). Название проекта заносится в переменную szProjectFile.
В качестве второго пара метра указывается размер области памяти, выделенной
под имя проекта. Третий параметр указывает адрес стру ктуры для анализа
ошибок. Если информация о возможных ошибках не требуется, можно передать
NULL.
•
Затем проверяется значение, возвращаемое функцией API DMGetRuntimeProject().
•
Далее полученное имя файла проекта выводится на печать. Резу льтаты работы
приведены в следующем разделе.
Вывод в окне диагностики
Пример, описываемый в данной главе, осуществляет в окне диагностики вывод
следующего текста:
Курс Си для WinCC 09.99
4-100
Руководство по конфигурации WinCC
C79000-G8276-C157-01
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-101
C79000-G8276-C157-01
4.9.2 Пример 2 — Определение пути проекта
В данном примере описывается процедура определения пути проекта WinCC.
Пример сконфигурирован для изображенной ниже кнопки Button2 в окне свойств
объекта в Event (Событие)
Mouse (Мышь) Mouse Action (Процедура
мыши).
Процедура Си, связанная с кнопкой Button2
•
В первой части описывается и инициализируется переменная bRet типа BOOL.
•
Затем описывается строковая переменная szProjectFile для размещения названия
файла про екта. Еще одна строковая переменная описывается как char* и
инициализируется значением NULL.
•
Далее описывается переменная типа CMN_ERROR.
•
После этого название проекта определяется при помощи функции API
DMGetRuntimeProject().
•
Затем проверяется значение, возвращаемое функцией API DMGetRuntimeProject().
•
После этого функция strrchr() ищет последнее вхождение символа \ в полученном
имени файла проекта. Сразу за найденным вхождением записывается 0. В
результате остается только описание пути проекта, без имени самого файла.
•
Далее полученный путь проекта выводится на печать. Результаты работы
приведены в следующем разделе.
Курс Си для WinCC 09.99
4-102
Руководство по конфигурации WinCC
C79000-G8276-C157-01
Вывод в окне диагностики
Пример, описываемый в данной главе, осуществляет в окне диагностики вывод
следующего текста:
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-103
C79000-G8276-C157-01
4.9.3 Пример 3 — Определение пути проекта с помощ ью
функции проекта
В данном примере процедура определения каталога прое кта WinCC переносится в
функцию проекта. Пример сконфигурирован для изо браженно й ниже кнопки Button3
в окне свойств объекта в Event (Событие) Mouse (Мышь) Mouse Action
(Процедура мыши).
Функция проекта GetProjectPath()
•
Функции проекта передается строковая переменная, в ко торую будет записан
полученный путь проекта. При вызове этой функции необходимо удостовериться
в том, что строковой переменной была выделена достато чная область памяти.
Успешность завершения работы функции можно оценить по ее возвращаемому
значению.
•
Процедура определения пути про екта организована так же, как и в предыдущем
примере.
•
Полу ченный путь проекта копируется в переданную строковую переменную
посредством функции strcpy().
Курс Си для WinCC 09.99
4-104
Руководство по конфигурации WinCC
C79000-G8276-C157-01
Процедура Си, связанная с кнопкой Button3
• В первой части описывается и инициализируется переменная bRet типа BOOL.
• Затем описывается строковая переменная szProjectFile для размещения пути
проекта.
• Использу я ранее созданную функцию проекта GetProjectPath() определяется путь
проекта. Затем проверяется значение, возвращаемое этой функцией.
• Далее полученный путь проекта выводится на печать.