2.2.3 平臺(tái)無關(guān)API

平臺(tái)無關(guān)API是應(yīng)用程序與GUI引擎之間實(shí)現(xiàn)通信的協(xié)議，其核心是一組基礎(chǔ)函數(shù)接口。Tilcon提供的擴(kuò)展API接口支持動(dòng)態(tài)創(chuàng)建界面對(duì)象和對(duì)象全屬性控制，使用非常簡(jiǎn)單便捷。以下函數(shù)接口分別用于初始化或終止GUI引擎通信，查詢通告信息，創(chuàng)建和刪除對(duì)象，設(shè)置或獲取對(duì)象屬性值。

■ TRT_Create()：創(chuàng)建應(yīng)用程序與GUI引擎的通信連接。

■ TRT_Delete()：關(guān)閉應(yīng)用程序與GUI引擎的通信連接。

■ TRT_Exit()：關(guān)閉所有窗口并退出GUI引擎。

■ TRT_GetInput()：向GUI引擎查詢事件或通知消息，從GUI引擎接收通知消息結(jié)構(gòu)體，并觸發(fā)回調(diào)函數(shù)。

■ TRT_GetValues()：獲取對(duì)象屬性值。

■ TRT_SetValues()：設(shè)置對(duì)象屬性值。

■ TRT_SimpleCreate()：使用SimpleObject結(jié)構(gòu)體創(chuàng)建預(yù)定義基本屬性/參數(shù)的簡(jiǎn)單對(duì)象。

■ TRT_StartEx()：?jiǎn)?dòng)GUI引擎。

■ TRT_WindowLoad()：加載TWD文件到內(nèi)存中。

以上核心API命令結(jié)合一系列設(shè)置屬性的<屬性名，屬性值>對(duì)一起使用，可以創(chuàng)建或編輯所有對(duì)象并設(shè)置對(duì)象的所有屬性，這種能力為開發(fā)者提供了對(duì)對(duì)象運(yùn)行時(shí)顯示效果和行為的超強(qiáng)動(dòng)態(tài)配置和精準(zhǔn)控制。其中，與對(duì)象屬性交互的核心接口是TRT_SetValues()和TRT_GetValues()，這兩個(gè)函數(shù)的參數(shù)數(shù)量是可變的、成對(duì)出現(xiàn)的，最后一個(gè)變量必須是NULL指針，以標(biāo)識(shí)參數(shù)列表的結(jié)束。成對(duì)出現(xiàn)的參數(shù)對(duì)中前者表示被修改或查詢的屬性名稱，后者表示設(shè)置的屬性值或查詢結(jié)果的存放位置。

Tilcon提供的GUI引擎是跨平臺(tái)的（支持VxWorks 6.x和風(fēng)河Linux），TWD文件是二進(jìn)制資源文件，使得圖形用戶界面是完全平臺(tái)無關(guān)的。因此，在實(shí)現(xiàn)跨平臺(tái)時(shí)無須進(jìn)行重新編譯和鏈接。另外，平臺(tái)無關(guān)API接口在所有平臺(tái)上都是一致的，這樣開發(fā)者可以在Windows PC上全程進(jìn)行GUI/HMI開發(fā)，無須關(guān)心RTOS目標(biāo)硬件和應(yīng)用軟件開發(fā)工作是否完成。