第二章 WinCC C语言基础
要使对象动态化，在WinCC中有多种不同的选项可用。其中包括变量
连接.动态对话框和直接连接。通过它们可以实现复杂的动态。然而，随着
要求的增加它们会有限制。对于用户来说，组态C动作、项目函数或动作
可以有更广的范围。它们在WinCC 脚本语言C中创建。对于许多应用来说，
不必具备非常全面的C语言知识。它足以为现有函数提供参数。然而，为
了使用WinCC脚本语言C的全部功能，需要具备有关这种编辑语言的基本
知识。本课程可以为用户提供这些知识。
本课程用来为不熟悉C语言的人员提供有关编辑语言C的常规应用的基
本知识。具备C语言编辑经验的编程员可以学习C语言应用于WinCC时的
特性。
2.1 C脚本的开发环境
对于C脚本的创建，WinCC提供两个不同的编辑器。一个是图形编辑
器中的动作编辑器，用于在对象处创建C动作；另一个是全局脚本编辑器，
用于创建项目函数和全局动作。脚本语言的语法与采用ANSI的标准C语言
相一致。
在WinCC中编辑语言C的另一个应用领域是关于动态向导的创建。为
此，可以使用一个单独的编辑器。
2.1.1 图形编辑器的动作编辑器
在图形编辑器中，可以通过C动作使对象属性动作化。同样，也可以使
用C动作来响应对象事件。
1．动作编辑器
对于C动作的组态，可以使用动作编辑器。此编辑器可以在对象属性对
话框中通过以下方法打开，即点击鼠标右键期望的属性或事件，然后从显示
的弹出式菜单中选择C动作。已经存在的C动作在属性或事件处用绿色箭
头标记。在动作编辑器中，可以编写C动作。对于属性的C动作，必须定义触发
器。对于事件的C动作，由于事件本身就是触发器所以不必再定义。完成
的C动作必须进行编译，如果编译程序没有检测到错误，则可以通过单击
确定退出动作编辑器
2．C动作的结构
通常，一个C动作相当与C中的一个函数。C动作由两种不同类型：为
属性创建动作和为事件创建的动作。通常，属性的C动作用于根据不同的
环境条件控制此属性的值（例如变量的值）。对于这种类型的C动作，必
须定义触发器来控制其执行。事件的C动作来响应此事件。
3．属性的C动作
#include apdefap h
long-main(char* lpszPictureName.char* lpszObjectName.char*lpszPropert
yName)
{
/*1*/ long 1ReturnValue;
/*2*/ 1ReturnValue * GetTagSDword(*S32icourse-test-1*);
/*3*/ return 1ReturnValue;
}
上述实例代码代表一个典型的属性的C动作。各部分的含义描述如下：标题（灰色）：灰色阴影显示的前三行构成C的动作标题。该标题自动
生成并且不能更改。除返回类型（在实例代码中为long）之外，所有的函数
标题完全相同。将三个参数传送给C动作。它们是画面名称（Lpsz Picture
Name）,对象名(lpszObjectName)和属性名(lpszPropertyName).
变量声明（1）：在可以编辑的第一段代码中声明使用的变量。在本实
例代码中，指的是一个long型的变量。
数值计算（2）：在本段中，执行属性值的计算。在实例代码中，只读
入一个WinCC 变量的数值。
数值返回（3）：将计算得出的属性值赋给属性。这通过return命令来
完成
4．事件的C动作
#include apdefap.h*
void OnClicik(char* lpszPictureName.char* lpszObjectName.char* lpszP
ropertyName)
{
/*1*/ long 1Value;
/*2*/ 1Value * GetTagSDWord(*s32i-course-tset-1”);
SetIeft (lpszPictureName,lpszobjectName,1value);
}
上述实例代码代表一个典型的事件的C动作。各部分含义描述如下：标题（灰色）：灰色阴影显示的前三行构成C动作的标题。该标题自动
生成并且不能更改。对于不同类型的事件，其参数标题也不同。将参数lps
zPictureName(画面名称).lpszObjectName(对象名)和lpszPropertyName(属性
名)传递给C动作。参数lpszPropertyName只包含与响应属性变化的事件相
关的信息。可以传递附加的事件指定的参数。
变量声明（1）：在可以编辑的第一代码段中声明使用的变量。在本实
例代码中，指的是一个long型的变量。
事件处理（2）：在本段中，执行响应事件的动作。在本实例代码中，
读入一个WinCC变量的数值。该数值作为位置X分配给自己的对象。事件
的C动作的返回值为void类型，也就是说不需要返回值
5．C动作的创建
创建C动作的步骤如下：
（1）.打开图形编辑器，打开期望的WinCC画面，打开所期望对象的对
象属性对话框
（2）通过鼠标R期望的属性或事件，然后从弹出式菜单中选择C动作
来打开动作编辑器
（3）将显示动作编辑器，其中将显示函数的基本框架。此外，C动作
的标题已经自动生成，该标题不能更改。
在C动作的标题的第一行内，包括文件apdefap.h.。通过该文件，向C
动作预告所有项目的函数.标准函数以及内部函数。C动作标题的第二部分
为函数标题。该函数标题提供有关C动作的返回值和可以在C动作中使用
的传送参数的信息。C动作标题的第三部分开始是花括弧。此花括弧不能删
除。在该开始大括弧和结束大括弧之间，编写C动作的实际代码。
（4）其他自动生成的代码部分包括两个注释块，若要使交叉索引编辑
器可以访问C动作的内部信息，则需要这些块，要允许C动作中语句重新
排列也需要这两个块。如果这些选项都不用。则可以删除这些注解。第一个块用于定义C动作中使用的WinCC变量。在程序代码中必须使
用定义变量名称而不是实际的变量名称
第二个注释块用于定义C中所使用的WinCC画面。在程序代码中也必
须使用定义的画面名称而不是实际画面名称。
（5）编写执行期望计算的函数主题、动作等。有多种编辑辅助工具可
供使用，其中一种辅助工具是变量选择对话框，此对话框如下所示的按钮可
以打开。在显示的选择变量对话框中，选择WinCC变量然后单击确定来确
认。于是在C动作中在当前光标位置处插入所选WinCC的变量名称。
（6）另一种辅助工具是动作编辑器左窗口中的函数选择。利用函数选
择，可以在C动作中的当前光标位置处自动插入所有可用的项目函数、标
准函数和内部函数。为此，通过鼠标D来选择其数据类型的列表。该函数
可以在数值列中进行参数化。除简单的文本输入以外，选择变量.图形对象
和画面选项都可以用。