SOUI 国际化¶

SOUI国际化系统
├── 翻译管理器 (TranslatorMgr)
├── 翻译器 (Translator)
└── 翻译资源
    ├── XML文件
    └── 其他资源

<?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>
        <!-- 更多翻译项 -->
    </context>
</language>

// 创建翻译管理器
CAutoRefPtr<ITranslatorMgr> transMgr;
transLoader.CreateInstance("translator.dll", (IObjRef**)&transMgr);

if(transMgr) {
    // 设置翻译管理器
    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);
    }
}

<editmenu trCtx="editmenu" iconSkin="_skin.sys.icons">
    <item id="1">cut</item>
    <item id="2">copy</item>
    <item id="3">paste</item>
</editmenu>

<window trCtx="mainwindow">
    <text>Hello</text>
    <button tip="close">Close</button>
</window>

// 使用TR宏
SStringT strText = TR(L"Hello World", L"mainwindow");

// 直接调用翻译函数
SStringT strText = SApplication::getSingleton().GetTranslator()
    ->tr(L"Hello World", L"mainwindow");

res/
└── translator/
    ├── lang_en.xml
    ├── lang_zh.xml
    └── lang_ja.xml

<!-- 按功能模块组织上下文 -->
<language>
    <!-- 通用翻译 -->
    <context name="common">
        <!-- 通用文本 -->
    </context>

    <!-- 编辑器相关 -->
    <context name="editor">
        <!-- 编辑器文本 -->
    </context>

    <!-- 特定对话框 -->
    <context name="dialog_settings">
        <!-- 设置对话框文本 -->
    </context>
</language>

class CMultiLangUI {
public:
    void UpdateLanguage(const SStringW& langFile) {
        // 加载新的语言文件
        CAutoRefPtr<ITranslator> newLang;
        transMgr->CreateTranslator(&newLang);

        // 加载翻译数据
        pugi::xml_document xmlLang;
        if(LoadLanguageFile(langFile, xmlLang)) {
            newLang->Load(&xmlLang.child(L"language"), 1);

            // 更新翻译器
            transMgr->UninstallTranslator(oldLang);
            transMgr->InstallTranslator(newLang);

            // 刷新UI
            UpdateAllWindows();
        }
    }

private:
    void UpdateAllWindows() {
        // 通知所有窗口更新文本
        // 实现窗口文本刷新逻辑
    }
};

// 根据条件选择不同的翻译
SStringT GetMessage(int code) {
    switch(code) {
        case 0:
            return TR(L"Success", L"common");
        case 1:
            return TR(L"Error", L"common");
        default:
            return TR(L"Unknown", L"common");
    }
}

// 带参数的翻译
SStringT FormatMessage(int count) {
    SStringT format = TR(L"Found %d items", L"common");
    SStringT result;
    result.Format(format, count);
    return result;
}

void SwitchLanguage(const SStringW& langId) {
    // 保存当前语言设置
    SaveCurrentLanguage();

    // 加载新语言
    LoadLanguage(langId);

    // 更新UI
    UpdateUILanguage();
}

void VerifyTranslation() {
    auto trans = SApplication::getSingleton().GetTranslator();

    // 检查翻译是否存在
    SStringT text = trans->tr(L"test", L"common");
    SASSERT(text != L"test"); // 如果返回原文，说明没有翻译
}

void ValidateContext() {
    // 验证上下文是否正确
    SWindow *pWnd = FindChildByName(L"test");
    SStringT ctx = pWnd->GetTrCtx();
    SASSERT(!ctx.IsEmpty()); // 确保设置了翻译上下文
}