本文導(dǎo)讀

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

創(chuàng)建UI項(xiàng)目后，在最上方的“項(xiàng)目”選項(xiàng)欄中，點(diǎn)擊翻譯按鈕，Designer將會(huì)打開(kāi)缺省的語(yǔ)言文件“strings.xml”。

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

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

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

添加語(yǔ)言：點(diǎn)擊"中EN+"按鈕，可以添加一種語(yǔ)言。

清空文本：點(diǎn)擊"清空"按鈕，可以刪除勾選的文本。

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

編輯文本：點(diǎn)擊文本編輯框，可以修改文本。

檢索項(xiàng)目的待翻譯文本：點(diǎn)擊"檢索"按鈕，可以檢索項(xiàng)目所有UI文件中待翻譯的文本，并更新到文本列表。

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

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

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

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

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

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

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

language_en_US

language_en

language_

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

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

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

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

資料分享

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

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