QTranslator 类

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();
}

成员函数文档

[显式] QTranslator::QTranslator(QObject *父 = nullptr)

构建一个空的带消息文件对象，以其父 parent 为参数，不连接到任何文件。

[虚拟 noexcept] QTranslator::~QTranslator()

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

QString QTranslator::filePath() const

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

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

[虚拟] 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区域设置（法语加拿大）的应用程序中，可能会调用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(const QLocale &, const QString &, const QString &, const QString &)函数，因为它使用QLocale::uiLanguages()而不是仅使用区域设置名称，这涉及到日期和数字的格式，而不一定是UI语言。

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

加载filename + prefix + ui语言名称 + suffix (未指定suffix时为".qm")，该文件可能是一个绝对路径，也可能相对于directory。如果翻译成功加载，则返回 true；否则返回 false。

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

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

1. 不带suffix的文件名。
2. 去除"_ "字符后的ui语言部分并添加suffix的文件名。
3. 去除ui语言部分并添加suffix的文件名。
4. 进一步去除ui语言部分，等等。

例如，在一个具有以下ui语言的区域设置中运行的程序 - "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 还会尝试加载区域名称的小写版本。

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

此函数重载了 load()。

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

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

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

[虚拟] 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()。