Siemens WinCC. Руководство по конфигурации. Том 1
Подождите немного. Документ загружается.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-115
C79000-G8276-C157-01
4.11 Стандартные диалоги
В проекте WinCC Project_C_Course примеры, относящиеся к стандартным диалогам,
можно открыть, щелкнув на изображенную ниже пиктограмму навигационной
панели. Примеры находятся на экранной форме, называющейся
cc_9_example_12.PDL.
Общие сведения
Обычная процедура для создания диалога в WinCC состоит из формирования кадра
WinCC и последу ющего его отображения в окне кадра (Picture Window). Помимо
этого, существует возможность создания стандартных диалогов в процедурах Си или
других функциях. В этом случае можно использовать как стандартные диалоги
WinCC, так и диалоги Windows.
В данной главе демонстрируется применение некоторых стандартных диалогов.
Су ществует ряд стандартных диалогов, которые здесь рассматриваться не будут.
Сведения о них можно найти в WinCC ODK и документации по Windows API.
Курс Си для WinCC 09.99
4-116
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.11.1 Пример 1 — Пер еключение языка
Приведенный ниже пример демо нстрирует возможности использования стандартного
диалога переключения языка в WinCC. Пример сконфигурирован для изображенной
ниже кнопки Button1 в окне свойств объекта в Event (Событие)
Mouse (Мышь)
Mouse Action (Процедура мыши).
Процедура Си, связанная с кнопкой Button1
• В первой части описываются используемые переменные. Помимо прочих
описывается массив идентификаторов (ID) трех используемых языко в.
• По заголовку окна с помощью функции Windows FindWindow() определяется
описатель окна среды исполнения. Обратите внимание, что указанный в д анном
примере заголовок окна не совпадает с заголовком окна среды исполнения,
устанавливаемым по умолчанию.
• Стандартный диалоговое окно переключения языка отображается при помощи
функции API DMShowLanguageDialog(). Этой функции передается массив
идентификатор языков, доступных для выбора. В передаваемую по указателю
переменную dwGetLocaleID фу нкция записывает идентификатор выбранного
языка.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-117
C79000-G8276-C157-01
•
Проверяется значение, возвращаемое функцией API DMShowLanguageDialog().
Одним из возможных возвращаемых значений является FALSE означающее, что
пользователь закрыл диалоговое окно нажатием на Cancel.
•
Используемый здесь диалоговое окно переключает только язык CS. Для того
что бы переключить язык RT, необходимо использовать внутреннюю функцию
SetLanguage(). Этой функции передается идентификатор выбранного языка.
Диалоговое окно выбора языка
Исполнение описанной выше процедуры Си приводит к отображению следующего
диалогового окна:
Курс Си для WinCC 09.99
4-118
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.11.2 Пример 2 — Выбор тега
Приведенный ниже пример демо нстрирует возможности использования стандартного
диалога выбора тега в WinCC. Значение выбранного в диалоговом окне тега
отображается в поле ввода/вывода. Пример сконфигурирован для изображенной ниже
кнопки Button2 в окне свойств объекта в Event (Событие)
Mouse (Мышь)
Mouse Action (Проце дура мыши).
Процедура Си, связанная с кнопкой Button2
• В первой части включается заголовочный файл trigger.h. В этом файле содержатся
описания используемых в д анном примере символьных констант.
• В следующей части описываются использу емые переменные. Помимо прочих
описываются переменные dmVarKey для размещения данных о выбранном в
диалоговом окне теге WinCC и link для хранения информации о связи с тегом.
• Название проекта определяется с помо щью функции API DMGetRuntimeProject().
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-119
C79000-G8276-C157-01
•
По заголовку окна с помощью функции Windows FindWindow() определяется
описатель окна среды исполнения.
•
Диалоговое окно выбора тега отображается при помощи функции API
DMShowVarDatabase().В передаваему ю по указателю переменную dmVarName
функция записывает информацию о выбранном в данном диалоге теге WinCC.
•
Если был выбран какой–либо тег, его имя показывается в статическом тексте, а
значение — в поле ввода/вывода.
Диалоговое окно выбора тега
Исполнение описанной выше процедуры Си приводит к отображению следующего
диалогового окна:
Курс Си для WinCC 09.99
4-120
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.11.3 Пример 3 — Диалоговое окно сообщения об ошибке
Приведенный ниже пример демо нстрирует возможности использования стандартного
Windows–диалогового окна сообщения об ошибке. Пример сконфигурирован для
изображенной ниже кнопки Button3 в окне свойств объекта в Event (Событие)
Mouse (Мышь) Mouse Action (Процедура мыши).
Процедура Си, связанная с кнопкой Button3
• В первой части описывается переменная hWnd типа HWND. В эту переменную
заносится описатель окна среды исполнения при помощи функции Windows
FindWindow().
• Посредством функции Windows MessageBox() открывается диалоговое окно
сообщения об ошибке. Второй и третий аргументы задают, соответственно, текст
сообщения и заголовок диалога. Четвертый аргумент определяет внешний вид и
поведение диалогового окна. Диалоговое окн о содержит только кнопку OK
(MB_OK), символ ошибки (MB_ICONSTOP) и я вляется модальным
(MB_APPLMODAL). Таким образом, пользователь до лжен подтвердить
сообщение об ошибке, перед тем как продолжить работу.
Error Box
Исполнение описанног о выше процеду ры Си приводит к отображению следующего
диалогового окна:
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-121
C79000-G8276-C157-01
4.11.4 Пример 4 — Диалоговое окно вопроса
Приведенный ниже пример демо нстрирует возможности использования стандартного
Windows–диалогового окна вопроса и последующих процедур, выполняемых в
зависимости от того, какая кнопка была нажата в диалоге. Пример сконфиг урирован
для изображенной ниже кнопки Button4 в окне свойств объекта в Event (Событие)
Mouse (Мышь) Mouse Action (Процедура мыши).
Процедура Си, связанная с кнопкой Button4
•
В первой части описывается переменная hWnd типа HWND. Кроме того,
описывается переменная iRet типа int.
•
По заголовку окна с помощью функции Windows FindWindow() определяется
описатель окна среды исполнения.
•
Посредством функции Windows MessageBox() открывается диалоговое окно
вопроса. Четвертый аргумент определяет внешний вид и поведение диалогового
окна. Диалоговое окно содержит только кнопки Yes и No (MB_YESNO), символ
вопроса (MB_ICONQUESTION) и я вляется модальным (MB_APPLMODAL).
Значение, возвращаемое функцией, заносится в переменную iRet.
•
В последней части анализируется значение, возвращаемое функцией. Если
диалоговое окно было закрыто нажатием на кнопку Yes, возвращаемое значение
— IDYES, если диалоговое окно было закрыто нажатием на кнопку No,
возвращаемое значение —IDNO.
Курс Си для WinCC 09.99
4-122
Руководство по конфигурации WinCC
C79000-G8276-C157-01
Диалоговое окно вопроса
Исполнение описанног о выше процеду ры Си приводит к отображению следующего
диалогового окна:
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-123
C79000-G8276-C157-01
4.11.5 Пример 5 — Стандартное диалоговое окно выбора
файла
Приведенный ниже пример демо нстрирует возможности использования стандартного
Windows–диалогового окна выбора файла. Пример сконфигурирован для
изображенной ниже кнопки Button5 в окне свойств объекта в Event (Событие)
Mouse (Мышь) Mouse Action (Процедура мыши).
Процедура Си, связанная с кнопкой Button5
•
В первой части подключается DLL Windows comdlg32.
•
В следующей части описываются требуе мые переменные. Помимо прочих
описывается переменная ofn структурного типа OPENFILENAME.
•
В следующей части переменная ofn заполняется данными.
Курс Си для WinCC 09.99
4-124
Руководство по конфигурации WinCC
C79000-G8276-C157-01
• Переменная ofn передается функции Windows GetOpenFileName(). Эта функция
открывает стандартное диалоговое окно выбора файла. Имя выбранного
пользователем файла заносится в переменную ofn. Имя выбранного файла
выводится на печать.
Стандартное диалоговое окно выбора файла
Исполнение описанног о выше процеду ры Си приводит к отображению следующего
диалогового окна:
Дополнительные примеры
Последующие примеры этой главы так же, как и пример 5, имеют отношение к
стандартным диалогам.
В примере 6 демонстрируется использование диалогового окна Save As.
В примере 7, создается функция проекта GetFileName(), облегчающая работу со
стандартными файловыми диалогами. Эта функция в зависимости от передаваемой
символьной константы отображает диалоговое окно Open или Save As. Для этого
испо льзуются символьные константы GFN_OPEN и GFN_SAVE.