本文導(dǎo)讀

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

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

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

多國語言編輯器的相關(guān)操作如下：

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

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

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

刪除文本：點擊文本右側(cè)的"×"按鈕，可以刪除對應(yīng)的文本。

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

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

AWTK根據(jù)原始文本查找當(dāng)前語言對應(yīng)的文本，如果找到則使用該文本進(jìn)行顯示，否則使用原始文本。

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

以按鈕為例，設(shè)置按鈕的原始文本為“btn”，添加三種語言，設(shè)置對應(yīng)的文本：

數(shù)字時鐘控件星期、時段和月份默認(rèn)支持翻譯：

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

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

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

language_en_US

language_en

language_

繪制好UI后，在程序中調(diào)用locale_info_change即可設(shè)置當(dāng)前語言：

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

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

增加三個單選按鈕，每個按鈕對應(yīng)一種語言，在回調(diào)函數(shù)中調(diào)用接口設(shè)置當(dāng)前語言，運行效果如下：

資料分享

HMI-ZDP1440開發(fā)套件資料持續(xù)更新中，需要獲取最新資料，可關(guān)注如下鏈接：

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