第九篇:在SOUI中使用多语言翻译

为UI在不同地区显示不同的语言是产品国际化的一个重要要求。

在SOUI中实现了一套类似QT的多语言翻译机制:布局XML不需要调整,程序代码也不需要调整,只需要为不同地区的用户提供不同的语言翻译文件即可。

在SOUI中,我们实现了一个使用明文XML的语言翻译模块:translator.dll

为了使用多语言翻译,首先需要准备一个语言翻译的XML文件。demo中使用的翻译文件如下:

<?xml version="1.0" encoding="utf-8"?>

<language name="ch" guid="{0DAEDE3C-6B94-4a81-9A55-C304FDD69D98}">

  <context>

    <!--没有上下文的翻译-->

  </context>

  <context name="editmenu">

    <message>

      <source>copy</source>

      <translation>复制</translation>

    </message>

    <message>

      <source>cut</source>

      <translation>剪切</translation>

    </message>

    <message>

      <source>paste</source>

      <translation>粘贴</translation>

    </message>

  </context>

  <context name="messagebox">

    <message>

      <source>ok</source>

      <translation>确定</translation>

    </message>

    <message>

      <source>cancel</source>

      <translation>取消</translation>

    </message>

    <message>

      <source>retry</source>

      <translation>重试</translation>

    </message>

  </context>

  <context name="dlg_main">

    <message>

      <source>close</source>

      <translation>关闭窗口</translation>

    </message>

  </context>

</language>

可以看到该XML中有一个language的根节点,该节点有两个属性:name和guid,这两个属性都是用来标识该翻译文件的。

在language节点下,有多个context节点,每个context节点有一个name属性(可以为空),对应一个翻译上下文。

每一个context下有不同数量的message结点,每个message又有两个子节点:source 和 translation。

source对应需要翻译的文字,而translation则对应翻译后的文字。

要使用这个语言翻译文件,首先需要从translator.dll中创建一个SOUI::ITranslatorMgr对象,并将该对象交给SOUI::SApplication管理。

再从ItranslatorMgr对象创建SOUI::ITranslator对象,并将Itranslator对象添加到ItranslatorMgr管理的翻译列表中。

最后还要为ITranslator对象加载翻译数据源(也就是前面提供的XML文件)。

下面是demo中使用和语言翻译相关的代码(见_tWinMain函数)

        SApplication *theApp=new SApplication(pRenderFactory,hInstance);//SOUI APP

        CAutoRefPtr<ITranslatorMgr> transMgr; //多语言翻译模块,由translator.dll提供

        transLoader.CreateInstance("translator.dll",(IObjRef**)&transMgr);//

        if(trans)

        {//加载语言翻译包

            theApp->SetTranslator(transMgr);

            pugi::xml_document xmlLang;

            if(theApp->LoadXmlDocment(xmlLang,_T("lang_cn"),_T("translator")))

            {

                CAutoRefPtr<ITranslator> langCN;

                transMgr->CreateTranslator(&langCN);

                langCN->Load(&xmlLang.child(L"language"),1);//1=LD_XML

                transMgr->InstallTranslator(langCN);

            }

        }

我们先看一下editmemu的XML:

<editmenu trCtx="editmenu" iconSkin="_skin.sys.icons" itemHeight="26" iconMargin="4" textMargin="8" >

  <item id="1" icon="3">cut</item>

  <item id="2" icon="4">copy</item>

  <item id="3" icon="5">paste</item>

  <item id="4" >delete</item>

  <sep/>

  <item id="5">select all</item>

</editmenu>

在这个XML中,根节点有一个属性trCtx,代表翻译上下文,对应语言翻译文件中的context中的name属性。

在这个menu定义中,所有的菜单项的文字全是英文。其中前面3项:cut, copy and paste在语言翻译文件中有对应的翻译项。

下图为程序运行时edit的右键菜单显示结果:

第九篇:在SOUI中使用多语言翻译

上面演示的是菜单资源的语言翻译,布局XML中的文字的翻译基本一样,只需要为布局的根结点定义一个翻译上下文(trCtx)(没有定义时则从没有指定name属性的context里查找翻译结果)。

可以参见demo的"close”按照的tooltip的翻译。

不管是菜单XML还是布局XML,它们都是静态的,经过设计需要使用代码往UI添加新的文字,同样也需要翻译,这个时候如何处理?

其实看一下静态资源翻译的代码就知道,要实现语言翻译,需要为每一句待翻译的文字调用一个函数:

SApplication::getSingleton().GetTranslator()->tr(const SStringW & strSrc,const SStringW & strCtx)

第一个参数是等翻译字符串,第二个参数是翻译上下文。

考虑到语句太长,系统提供了一个宏:

#define TR(p1,p2)       SApplication::getSingleton().GetTranslator()->tr(p1,p2)

这样用TR就可以实现文字翻译了。

 

你可能感兴趣的:(多语言)