Siemens WinCC. Руководство по конфигурации. Том 1
Подождите немного. Документ загружается.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-105
C79000-G8276-C157-01
4.9.4 Пример 4 — Определение инсталляционного каталога
В данном примере описывается процедура определения инсталляционного каталога
WinCC. Пример сконфигур ирован для изображенной ниже кнопки Button4 в окне
свойств объекта в Event (Событие)
Mouse (Мышь) Mouse Action
(Процедура мыши).
Процедура Си, связанная с кнопкой Button4
•
В первой части описывается строковая переменная szProjectFile для размещения
названия файла проекта.
•
Затем описывается переменная dmDirInfo для хранения данных о каталоге. Эта
структурная переменная имеет тип DM_DIRECTORY_INFO.
•
Далее описывается переменная CMN_ERROR.
•
После этого описывается строковая переменная типа char* и инициализируется
значением NULL.
•
Название проекта определяется с помо щью функции API DMGetRuntimeProject().
•
При помощи функции API DMGetProjectDirectory() в переменную dmDirInfo
заносятся данные о каталогах. Один из путей, описываемых данной переменной,
является путем к каталогу глобальной библиотеки (Global Library). Этот путь
Курс Си для WinCC 09.99
4-106
Руководство по конфигурации WinCC
C79000-G8276-C157-01
хранится в поле szGlobalLibDir. Каталог глобальной библиотеки является
подкаталогом инсталляционного каталога WinCC.
• Первый вызов функции strrchr() возвращает позицию последнего символа \ , в
которую затем записывается 0. Второй вызов функции strrchr() возвра щает
позицию последнего символа \ в оставшейся части пути. В ячейку, следующую
непосредственно за этой позицией, записывается 0.
• Затем полученный инсталляционный каталог выводится на печать. Результаты
работы приведены в следующем разделе.
Вывод в окне диагностики
Пример, описываемый в данной главе, осуществляет в окне диагностики вывод
следующего текста:
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-107
C79000-G8276-C157-01
4.9.5 Пример 5 — Определение имени компьютера
В данном примере описывается процедура определения имени локального
компьютера. Пример сконфигурирован для изображенной ниже кнопки Button5 в
окне свойств объекта в Event (Событие)
Mouse (Мышь) Mouse Action
(Процедура мыши).
Процедура Си, связанная с кнопкой Button5
•
В первой части подключается DLL Windows Kernel32. Так как будет использована
только одна функция этой DLL, она объявляется вручную. Кроме то го,
описывается символьная константа для задания максимальной длины имени
компьютера.
•
Затем описывается и инициализируется переменная bRet типа BOOL.
•
Далее описывается строковая переменная szComputerName для размещения имени
компьютера. В дополнение описывается переменная типа DWORD,
инициализируемая длинной ранее созданной строковой переменной.
•
Имя локального компьютера определяется функцией Windows
GetComputerNameA(). Это имя записывается в переданную строковую
переменную szComputerName.
•
Далее проверяется значение, воз вращаемое функцией Windows
GetComputerNameA().
•
Затем полученное имя компьютера выводится на печать.
Курс Си для WinCC 09.99
4-108
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.9.6 Пример 6 — Определение имени пользователя
В данном примере описывается процедура определения имени текущего
зарегистрированного пользователя в Windows NT. Пример сконфигурирован для
изображенной ниже кнопки Button6 в окне свойств объекта в Event (Событие)
Mouse (Мышь) Mouse Action (Процедура мыши).
Процедура Си, связанная с кнопкой Button6
• В первой части подключается DLL Windows advapi32. Так как буде т использована
только одна функция этой DLL, она объявляется вручную. Кроме то го,
описывается символьная константа для задания максимальной длины имени
пользователя.
• Затем описывается и инициализируется переменная bRet типа BOOL.
• Далее описывается строковая переменная szUserName для размещения имени
пользователя. В дополнение описывается переменная типа DWORD,
инициализируемая длинной ранее созданной строковой переменной.
• С помощью функции Windows GetUserNameA() определятся имя текущего
зарегистрированного пользователя в Windows NT. Это имя записывается в
переданную строковую переменную szUserName.
• Далее проверяется значение, воз вращаемое функцией Windows GetUserNameA().
• Затем полученное имя пользователя выводится на печать.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-109
C79000-G8276-C157-01
4.10 Windows API
Примеры, описанные в данной главе, находятся на экранных формах
cc_0_startpicture_00.PDL и cc_2_keyboard_01.PDL проекта WinCC Project_C_Course.
Программный интерфейс Windows
В проектах WinCC помимо WinCC API можно также использовать весь Windows
API. Это предос тавляет практически нео граниченный доступ к системе.
Приведенные ниже примеры дают общее представление о таких возможностях. Они
демонстрируют основные принципы использования Windows API. Тем не менее, это
отнюдь не исчерпывающий курс по Windows API.
Функции Windows API располагаются в различных DLL, так же как функции WinCC
API. Объявления этих функций находятся в различных заголовочных файлах.
Подключение DLL Windows выполняется таким же образом, как и по дключение DLL
WinCC. Следующий фрагмент кода иллюстрирует подключение DLL.
Курс Си для WinCC 09.99
4-110
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.10.1 Пример 1 — Установка свойств окна
Данный пример иллюстрирует возможность изменения свойств окна Windows. В нем
производится изменение заголовка и формы окна среды исполнения. Пример связан с
событием Event (Событие)
Miscellaneous (Разное) Open Picture
(Открытие экранной формы) стартовой экранной формы cc_0_startpicture_00.PDL.
Процедура Си, связанная со стартовой экранной формой
• Функции Windows, использующиеся в данном примере, уже известны проекту
WinCC. Следовательно, необходимость загрузки каких–либо DLL Windows
отсу тс твует.
• В первой части описывается переменная типа HWND и инициализируется
значением NULL. Эта переменная — так называемый описатель окна —
представляет собой указатель, ссылающийся на окно Windows.
• Описатель окна может быть по лучен по заголовку этого окна с помощью функции
Windows FindWindow(). Описатель окна среды исполнения WinCC можно
определить в слу чае, если это окно имеет заданный по у молчанию заголовок
• Заголовок окна среды исполнения можно изменить при по мо щи функции
Windows SetWindowText(). В данном примере в качестве заголовка указывается
WinCC C-Course.
• Координаты и размеры отображаемого окна среды исполнения можно изменить
при помощи функции Windows SetWindowPos(). В данном примере окно
перемещается в левый верхний угол экрана (координаты 0/0) и растягивается до
размера 1024 на 768.
• Остальные выражения приведенного выше фрагмен т а кода осуществляют
инициализационные процедуры на имеющие отно шения к данному примеру.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-111
C79000-G8276-C157-01
4.10.2 Пример 2 — Считывание системного времени
Данный пример показывает, как можно считывать и отображать системные дату и
время. Пример привязан к экранной форме cc_0_startpicture_00.PDL.
Процедура Си, связанная со статическим текст ом Time
•
В первой части подключается DLL Windows Kernel32. Так как будет использована
только одна функция этой DLL, она объявляется вручную.
•
Затем описывается переменная sysTime типа SYSTEMTIME. Это структурная
переменная для хранения системного времени.
•
Далее описывается строковая переменная szTime для размещения текущего
времени в формате hh:mm.
•
Текущее системное время считывается при помощи функции Windows
GetLocalTime() и заносится в переменную sysTime.
•
После этого посредством функции sprintf() текущее системное время приводится
к формату hh:mm, после чего полученная строка используется как воз вращаемое
функцией значение. Другое процедура Си создается аналогичным образом для
свойства Property (Свойство)
Miscellaneous (Разное) Tooltip Text
(Текст подсказки). Это процеду ра Си ген ерирует текущую дату
.
•
Функция исполняется с периодичностью 1s.
Курс Си для WinCC 09.99
4-112
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.10.3 Пример 3 — Воспроизведение звуковых файлов
Данный пример показывает, как можно воспроизводить звуковые файлы.
Воспроизведение звукового файла производится при переключении между
навигационными панелями Basics и WinCC and Windows API. Пример связан с
кнопкой Button1 экранной формы cc_2_keyboard_01.PDL.
Функция проекта CC_PlaySound()
• В первой части включается заголовочный файл apdefap.h. В результате этого из
данной функции проекта могут вызываться другие функции проекта.
• В заголовке функции в качестве аргумента описывается строковая переменная.
Она используется для передачи имени звукового файла, подлежащего
воспроизведению.
• В следующей части подключается DLL Windows winmm. Так как бу дет
использована только одна функция этой DLL, она объявляется вручную. Кроме
того, описываются две символьные константы.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-113
C79000-G8276-C157-01
•
Функция проекта предполагает наличие в каталоге проекта подкаталога Sound. В
данном подкаталог е хранятся используемые в проекте звуковые файлы. Путь к
искомому звуковому файлу составляется из пути проекта, имени каталога
звуковых файлов и имени самого звукового файла. Этот путь будет помещен в
переменную szSoundPath.
•
Звуковой файл воспроизводится с помощью функции Windows PlaySound(). Если
воспр оизведение звукового файла невозможно, то вместо этого функцией
Windows MessageBeep() будет сгенерирован короткий сигнал.
Курс Си для WinCC 09.99
4-114
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.10.4 Пример 4 — Запуск программы
Данный пример иллюстрирует процедуру запуска программы. Для этой цели
используется уже существ ую щая стандартная фу нкция, использу ющая Windows API.
Пример приведен на экранной форме cc_0_startpicture_00.PDL.
Стандартная функция ProgramExecute()
• Стандартная функция ProgramExecute() просто перенаправляет переданные ей
аргументы в функцию Windows WinExec(). Значение, возвращаемое функцией
WinExec() направляется фу нкции, вызвавшей ProgramExecute(). Если запуск
программы произведен успешно, возвраща емое значение больше 31.
Процедура Си, связанная с графи ческим объектом Execute
• При помощи с тандартной функции ProgramExecute(), производится запуск
программы calc.exe. Это программа Windows “Калькулятор”. Путь не
указывается, т.к. для программ, расположенных в катало ге Windows, в этом нет
необходимости.