QTranslator Class

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    QTranslator translator;
    // look up e.g. :/i18n/myapp_de.qm
    if (translator.load(QLocale(), "myapp"_L1, "_"_L1, ":/i18n"_L1))
        QCoreApplication::installTranslator(&translator);

    QPushButton hello(QCoreApplication::translate("main", "Hello world!"));
    hello.resize(100, 30);

    hello.show();
    return app.exec();
}

成员函数文档

[explicit] QTranslator::QTranslator(QObject *parent = nullptr)

构造一个空的消息文件对象，其父parent 未连接到任何文件。

[virtual noexcept] QTranslator::~QTranslator()

销毁对象并释放已分配的资源。

QString QTranslator::filePath() const

返回已加载翻译文件的路径。

如果尚未加载翻译文件、加载失败或未从文件加载翻译文件，则文件路径为空。

[virtual] bool QTranslator::isEmpty() const

如果该翻译文件为空，则返回true ，否则返回false 。此函数适用于已剥离和未剥离的翻译文件。

QString QTranslator::language() const

返回翻译文件中存储的目标语言。

bool QTranslator::load(const QString &filename, const QString &directory = QString(), const QString &search_delimiters = QString(), const QString &suffix = QString())

加载filename +suffix （如果未指定suffix ，则加载".qm"），它可以是一个绝对文件名，也可以是directory 的相对文件名。如果翻译成功加载，则返回true ；否则返回false 。

如果未指定directory ，则使用当前目录（即currentPath() ）。

该翻译对象之前的内容将被丢弃。

如果文件名不存在，将按以下顺序尝试其他文件名：

1. 未附加suffix 的文件名。
2. 文件名中search_delimiters 字符后的文本已剥除（如果search_delimiters 为空字符串，则默认为"_."），suffix 。
3. 文件名已剥离，但未附加suffix 。
4. 进一步剥离的文件名，等等。

例如，在 fr_CA locale（加拿大法语区）运行的应用程序可能会调用 load("foo.fr_ca","/opt/foolib")。然后，load() 会尝试打开该列表中第一个现有的可读文件：

1. /opt/foolib/foo.fr_ca.qm
2. /opt/foolib/foo.fr_ca
3. /opt/foolib/foo.fr.qm
4. /opt/foolib/foo.fr
5. /opt/foolib/foo.qm
6. /opt/foolib/foo

通常，最好使用 QTranslator::load(constQLocale &, constQString &, constQString &, constQString &, constQString &) 函数，因为它使用的是QLocale::uiLanguages() 而非简单的本地名称，后者指的是日期和数字的格式，而不一定是用户界面语言。

bool QTranslator::load(const QLocale &locale, const QString &filename, const QString &prefix = QString(), const QString &directory = QString(), const QString &suffix = QString())

加载filename +prefix +ui language name +suffix （如果未指定suffix ，则为".qm"），它可以是一个绝对文件名，也可以是directory 的相对文件名。如果翻译成功加载，则返回true ；否则返回false 。

该翻译对象之前的内容将被丢弃。

如果文件名不存在，将按以下顺序尝试其他文件名：

1. 未附加suffix 的文件名。
2. 文件名中"_"字符后的 ui 语言部分被去掉，suffix 。
3. 文件名的 ui 语言部分被去掉，但未附加suffix 。
4. 文件名的 ui 语言部分被进一步剥离，等等。

例如，在locale 中运行的应用程序如果使用以下ui languages - "es"、"fr-CA"、"de"，可能会调用 load(QLocale(), "foo",".","/opt/foolib",".qm")。load() 会用ui 语言中的"_"（下划线）替换"-"（破折号），然后尝试打开列表中第一个现有的可读文件：

1. /opt/foolib/foo.es.qm
2. /opt/foolib/foo.es
3. /opt/foolib/foo.fr_CA.qm
4. /opt/foolib/foo.fr_CA
5. /opt/foolib/foo.fr.qm
6. /opt/foolib/foo.fr
7. /opt/foolib/foo.de.qm
8. /opt/foolib/foo.de
9. /opt/foolib/foo.qm
10. /opt/foolib/foo.
11. /opt/foolib/foo

在文件系统区分大小写的操作系统上，QTranslator 也会尝试加载小写版本的 locale 名称。

bool QTranslator::load(const uchar *data, int len, const QString &directory = QString())

此函数重载 load()。

将长度为len 的 QM 文件数据data 加载到翻译器中。

数据不会被复制。调用者必须能够保证data 不会被删除或修改。

directory 仅用于在加载 QM 文件的依赖项时指定基本目录。如果文件没有依赖关系，则忽略该参数。

[virtual] QString QTranslator::translate(const char *context, const char *sourceText, const char *disambiguation = nullptr, int n = -1) const

返回密钥 (context,sourceText,disambiguation) 的翻译。如果找不到，也会尝试 (context,sourceText, "" )。如果仍然失败，则返回空字符串。

如果n 不是-1，它将用于选择适当的翻译形式（例如 "找到 %n 文件 "与 "找到 %n 文件"）。

如果需要以编程方式将翻译插入QTranslator ，可以重新实现该函数。

另请参阅 load()。