本文導讀

ZDP1440是一款基于開源GUI引擎的圖像顯示專用驅動芯片，在實際項目中，可能有切換多國語言的需求，AWTK默認支持多國語言，本文將介紹如何使用該功能。

創建UI項目后，在最上方的“項目”選項欄中，點擊翻譯按鈕，Designer將會打開缺省的語言文件“strings.xml”。

Designer默認使用多國語言編輯器打開語言文件。多國語言編輯器是一個翻譯文本列表，可以編輯翻譯文本。

多國語言編輯器的相關操作如下：

添加文本：點擊"T+"按鈕，可以添加一條翻譯文本。

添加語言：點擊"中EN+"按鈕，可以添加一種語言。

清空文本：點擊"清空"按鈕，可以刪除勾選的文本。

刪除文本：點擊文本右側的"×"按鈕，可以刪除對應的文本。

編輯文本：點擊文本編輯框，可以修改文本。

檢索項目的待翻譯文本：點擊"檢索"按鈕，可以檢索項目所有UI文件中待翻譯的文本，并更新到文本列表。

AWTK根據原始文本查找當前語言對應的文本，如果找到則使用該文本進行顯示，否則使用原始文本。

對于大部分控件來說，Designer用下圖所示的圖標標記控件的文本是否需要翻譯，沒有標記則不會進行翻譯：

以按鈕為例，設置按鈕的原始文本為“btn”，添加三種語言，設置對應的文本：

數字時鐘控件星期、時段和月份默認支持翻譯：

在翻譯中添加星期和月份對應的中英文翻譯，此時若對應的語言中沒有翻譯的文本，則會顯示原始文本：

在一些應用程序中，有些文字是直接繪制在圖片上的。所以在切換到不同的語言時，需要加載不同的圖片。這時只要在圖片名稱中包含『$locale$』即可，加載時自動替換成當前的語言。

如：圖片名稱為『language_$locale$』，當前語言為 en_US，加載圖片時會按下列順序查找：

language_en_US

language_en

language_

繪制好UI后，在程序中調用locale_info_change即可設置當前語言：

第一個參數為locale_info()，第二個為語言，第三個為國家或地區。以中文為例，語言為“zh”，國家或地區為“CN”：

locale_info_change(locale_info(), “zh”, “CN”);

增加三個單選按鈕，每個按鈕對應一種語言，在回調函數中調用接口設置當前語言，運行效果如下：

資料分享

HMI-ZDP1440開發套件資料持續更新中，需要獲取最新資料，可關注如下鏈接：

https://gitee.com/zlgmcuopen/HMI_ZDP1440D。