2.2.3 平台无关API

平台无关API是应用程序与GUI引擎之间实现通信的协议，其核心是一组基础函数接口。Tilcon提供的扩展API接口支持动态创建界面对象和对象全属性控制，使用非常简单便捷。以下函数接口分别用于初始化或终止GUI引擎通信，查询通告信息，创建和删除对象，设置或获取对象属性值。

■ TRT_Create()：创建应用程序与GUI引擎的通信连接。

■ TRT_Delete()：关闭应用程序与GUI引擎的通信连接。

■ TRT_Exit()：关闭所有窗口并退出GUI引擎。

■ TRT_GetInput()：向GUI引擎查询事件或通知消息，从GUI引擎接收通知消息结构体，并触发回调函数。

■ TRT_GetValues()：获取对象属性值。

■ TRT_SetValues()：设置对象属性值。

■ TRT_SimpleCreate()：使用SimpleObject结构体创建预定义基本属性/参数的简单对象。

■ TRT_StartEx()：启动GUI引擎。

■ TRT_WindowLoad()：加载TWD文件到内存中。

以上核心API命令结合一系列设置属性的<属性名，属性值>对一起使用，可以创建或编辑所有对象并设置对象的所有属性，这种能力为开发者提供了对对象运行时显示效果和行为的超强动态配置和精准控制。其中，与对象属性交互的核心接口是TRT_SetValues()和TRT_GetValues()，这两个函数的参数数量是可变的、成对出现的，最后一个变量必须是NULL指针，以标识参数列表的结束。成对出现的参数对中前者表示被修改或查询的属性名称，后者表示设置的属性值或查询结果的存放位置。

Tilcon提供的GUI引擎是跨平台的（支持VxWorks 6.x和风河Linux），TWD文件是二进制资源文件，使得图形用户界面是完全平台无关的。因此，在实现跨平台时无须进行重新编译和链接。另外，平台无关API接口在所有平台上都是一致的，这样开发者可以在Windows PC上全程进行GUI/HMI开发，无须关心RTOS目标硬件和应用软件开发工作是否完成。