Siemens WinCC. Руководство по конфигурации. Том 1
Подождите немного. Документ загружается.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-65
C79000-G8276-C157-01
4.6.3 Запись в переданный диапазо н адресов
В данном примере создается простая функция для заполнения массива произвольной
длины псевдослучайными числами. Функции передается адрес массива и его длина.
Функция возвращает зн ачение типа BOOL, указывающее, успешно ли произошло
завершение работы. Пример сконфигурирован для изображенной ниже кнопки
Button3 в окне свойств объекта в Event (Событие)
Mouse (Мышь) Mouse
Action (Процедура мыши).
Функция проекта FillArray()
•
В заголовке в качестве имени функции указывается FillVector(). В качестве
аргумента функции передается указатель на int. Данный указатель ссылается на
первый элемент передава емого массива. Допо лнительно в фу нкцию передается
длина массива. Функция возвращает значение типа BOOL, указывающее, успешно
ли произошло завершение работы.
•
Далее описывается переменная–счетчик типа int.
•
Затем проверяется переданный указатель. Вызывающая программа должна
правильно указать длину массива. Передача некорректного значения может
привести к общей ошибке доступа.
•
В цикле for элементы переданного массива заполняются произвольными
(псевдослучайными) значениями, генерируемыми фу нкцией rand().
Курс Си для WinCC 09.99
4-66
Руководство по конфигурации WinCC
C79000-G8276-C157-01
Процедура Си, связанная с кнопкой Button3
• В первой части описывается символьная константа VECTOR_SIZE, определяющая
количество элементов массива.
• Далее описывается массив iVector, со стоящий из VECTOR_SIZE элементов типа
int.
• Затем описывается переменная–счетчик i типа int.
• Использу я ранее созданную функцию FillVector(), массив iVector заполняется
произвольными числами. При вызове фу нкции FillVector() ее возвращаемое
значение проверяется при помощи условного оператора if.
• Значения элементов массива iVector выводятся на печать при помощи функции
printf(). Ре зультаты работы приведены в следующем разделе.
Вывод в окне диагностики
Пример, описываемый в данной главе, осуществляет в окне диагностики вывод
следующего текста:
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-67
C79000-G8276-C157-01
4.6.4 Возврат результата по указателю
В данном примере создается простая функция для формирования массива
произвольной длины со случайными числами. Фу нкции передается требуемая длина
массива. Фу нкция возвращает адрес первого элемента созданного массива. Пример
сконфигурирован для изображенной ниже кнопки Button4 в окне свойств объекта в
Event (Событие)
Mouse (Мышь) Mouse Action (Процедура мыши).
Функция проекта GetFilledArray()
•
В заголовке в качестве имени функции указывается GetFilledVector(). В качестве
аргумента функции передается количество элементов в массиве, который
необходимо создать. Функция возвращает указатель типа int*, ссылающийся на
первый элемент массива.
Курс Си для WinCC 09.99
4-68
Руководство по конфигурации WinCC
C79000-G8276-C157-01
• Далее описывается указатель piVector не переменную типа int, который
инициализируется значением NULL.
• Затем описывается переменная–счетчик i типа int.
• Для массива должна быть выделена до статочная область памяти. Это делается
при помощи внутренней фу нкции SysMalloc(). Ей передается размер
необходимого блока памяти, вычисляемый как произведение ра змера переменной
типа int на количество элементов массива. Функция воз вращает адрес выделенной
области памяти, или NULL, если памяти недостаточно.
• После этого производит ся проверка адреса, полученного от функции SysMalloc().
Если памяти для выделения требуемого блока недостаточно, фу н к ция
завершается и возвращает NULL.
• В цикле for элементы массива заполняются псевдослучайными значениями,
генерируемыми функцией rand().
• Посредством команды возврата return адрес созданного массива передается в
основную программу.
Процедура Си, связанная с кнопкой Button4
• В первой части описывается символьная константа VECTOR_SIZE, определяющая
количество элементов массива.
• Далее описывается указатель piVector на переменную типа int и инициализируется
значением NULL.
• Затем описывается переменная–счетчик i типа int.
• Использу я ранее созданную функцию GetFilledVector(), создается массив из
произвольных чисел, а его адрес записывается в указатель piVector. Зн ачение,
возвращаемое функцией GetFilledVector(), проверяется на корректность.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-69
C79000-G8276-C157-01
•
Значения элементов созданного массива выводятся на печать при по мощи
функции printf(). Результаты работы приведены в следующем разделе.
Вывод в окне диагностики
Пример, описываемый в данной главе, осуществляет в окне диагностики вывод
следующего текста:
Замечание:
Методы передачи структур между функцией и основной программой описываются в
следующей главе.
Курс Си для WinCC 09.99
4-70
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.7 Струк туры
В проекте WinCC Project_C_Course примеры, относящиеся к работе со структурами,
можно открыть, щелкнув на изображенную ниже пиктограмму навигационной
панели. Примеры находятся на экранной форме, называющейся
cc_9_example_04.PDL.
Определение структурного типа
Помимо применения стандартных типов данных пользователь имеет воз можность
создавать свои собственные струк т урные типы. В следующем фраг мен те программы
поясняются основы определения структурных типов. Созданный структу рный тип
данных состоит из одного элемента типа int и одного элемента типа float. Каждому
структу рному типу необходимо присваивать собственное имя.
Использование структурных переменных
Как показано в приведенном ниже примере, после определения новог о структурного
типа можно описывать переменные типа struct ExampleStruct. Этот пример также
демонстрирует метод доступа к полям переменной структурного типа.
Если вместо структурной переменной имеется лишь указатель, ссылающийся на нее,
то доступ к отдельным полям данной структуры можно получить так же, как это
сделано в следующем примере программы. Удостоверьтесь, что указатель ссылается
на реально существующую структурную переменную, или, по крайней мере, на
область памяти, выделенную под нее.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-71
C79000-G8276-C157-01
4.7.1 Пример 1 — Структурная переменная
В данном примере поясняются основные принципы создания и испо льзования
переменной структурного типа. Пример сконф иг урирован для изображенного ниже
статическог о текста StaticText1 в окне свойств объекта в Event (Событие)
Mouse (Мышь) Mouse Action (Процедура мыши).
Процедура Си, связанная со ста тическим текстом Static Text1
•
В первой части производится определение структурного типа CC_POINT,
состоящего из двух элементов типа int. Данный структурный тип предназначен
для описания координат щелчка мыши.
•
Затем описывается структурная переменная posObject типа struct CC_POINT.
•
Далее элементам (по лям) объекта posObject присваиваются определенные
значения. Эти значения представляют собой координаты щелчка мыши. Они
передаются Си–действи ю, привя занному к событию Event (Событие)
Mouse
(Мышь)
Mouse Press Left (Нажатие левой кнопки) в виде аргументов x и y.
•
После этого координаты объекта устанавливаются равными значениям полей
структу рной переменной при помощи функций SetLeft() и SetTop().
Курс Си для WinCC 09.99
4-72
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.7.2 Пример 2 — Определение пользоват ельского типа
данных
В данном примере поясняются основные принципы определения и применения
пользовательского типа данных. В отличие от предыдущего примера этот
структурный тип данных доступен в рамках всего проекта, а не только в Си–
действии. Пример сконфигурирован для изображенной ниже кнопки Button2 в окне
свойств объекта в Event (Событие)
Mouse (Мышь) Mouse Action
(Процедура мыши).
Определение структуры в apdefap.h
• Определяется структурный тип tagCC_RECT, состоящий из четырех элементов
типа int. Данный стру кту рный тип предназначен для описания координат и
размеров прямоугольной области. Затем описывается структурная переменная
типа struct tagCC_RECT. Чтобы избежать громоздкой нотации можно
использовать псевдоним, определяемый посредством команды переименования
типов typedef. Если Вы хотите описать переменную данного типа, достаточно
указать псевдоним CC_RECT. Если необходимо описать указатель, ссылающийся
на переменную этого типа, можно использовать псевдоним PCC_RECT.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-73
C79000-G8276-C157-01
Процедура Си, связанная с кнопкой Button2
•
В первой части описывается и инициализируется переменная rect типа CC_RECT.
•
Далее описывается переменная prect типа PCC_RECT и инициализируется
значением NULL. Этот тип данных является указателем на переменную типа
CC_RECT.
•
Затем, посредством оператора . , производится доступ к элементам стру ктурной
переменной rect. Ее содержимое выводится на печать при помощи функции
printf().
•
После этого адрес переменной rect присваивается указателю prect. Затем,
посредством оператора –>, осуществляется доступ к элементам стру ктурного
типа, на который ссылается указатель prect. Содержимое структурной переменной
вновь выводится на печать при помо щи функции printf(). Результаты работы
программы приведены в следу ющем разделе.
Вывод в окне диагностики
Пример, описываемый в данной главе, осуществляет в окне диагностики вывод
следующего текста:
Курс Си для WinCC 09.99
4-74
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.7.3 Пример 3 — Структурный тип WinCC
В данном примере поясняются основные принципы определения и применения
структу рного типа WinCC. Его формат идентичен использованному в предыдущем
примере типу CC_RECT. В отличие от предыдущего примера этот структурный тип
данных доступен в рамках всего проекта, а не то лько в Си–действии. Пример
сконфигурирован для изображенной ниже кнопки Button3 в окне свойств объекта в
Event (Событие)
Mouse (Мышь) Mouse Action (Процедура мыши).
Создание структурного типа WinCC
Шаг Процедура создания структурного типа WinCC
1
Новый структурный тип WinCC создается в WinCC Explorer. Щелкните
правой кнопкой мыши
R на пункт Structure Types и выберите во
всплывающем меню пункт New Structure Type. Пос ле этого откроется
диалоговое окно для описания свойств новой структуры WinCC.
2 Откроется диалоговое окно Structure Properties.
Необходимо задать имя нового стр ук т урного типа. Это делается нажатием
на правую кнопку мыши
R на задаваемом по умолчанию имени
NewStructure и последующим выбором пункта Rename во всплывающем
меню. В данном примере используется имя Rect.
3 Описание элементов нового структурного типа.
Новый элемент можно добавить при помощи кнопки New Element. Имя и
тип добавляемого элемента указываются нажатием на нем правой кнопкой
мыши
R. В данном примере элемент назван Left и и меет тип LONG. Для
него выбран пункт переключателя Internal Tag. Имена и типы остальных
элементов показаны на приведенном ниже кадре.
Теперь диалоговое окно Structure Properties (Свойств структуры) можно
закрыть, нажав на OK.