Qt：QTranslator类

最新推荐文章于 2024-07-11 13:07:34 发布
最新推荐文章于 2024-07-11 13:07:34 发布
阅读量6.7k 收藏 11
点赞数 8
分类专栏： C++
原文链接：https://doc.qt.io/qt-6/qtranslator.html
版权
C++ 专栏收录该内容
1060 篇文章 292 订阅
订阅专栏

QTranslator类为文本输出提供国际化支持

头文件：

#include <QTranslator>

cmake:

find_package(Qt6 COMPONENTS Core REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::Core)

qmake:

QT += core

继承自：

QObject

详细说明

该类的对象包含一组从源语言到目标语言的翻译。QTranslator提供了在翻译文件中查找翻译的函数。翻译文件是使用Qt Linguist创建的。

QTranslator最常见的用途是:加载翻译文件，并使用QCoreApplication::installTranslator()安装它。

下面是一个使用QTranslator的main()函数示例:

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

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

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

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

在这里插入图片描述

注意，必须在应用程序的小部件之前创建translator。

大多数应用程序永远不需要使用这个类做任何其他事情。这个类提供的其他函数对于处理translator文件的应用程序很有用。

查找翻译

可以使用translate（）查找翻译（就像tr（）和QCoreApplication :: translate（）一样）。translate()函数最多有三个形参:

  • context ：通常是tr()调用者的类名
  • source text ：通常是tr()的参数。
  • disambiguation（消除歧义） ：一个可选的字符串，帮助消除同一文本在同一上下文中的不同用法的歧义。

例如，当程序以波兰语运行时，对话框中的“Cancel”可能有“Anuluj”（在本例中，源文本是“Cancel”）。上下文（通常）是对话框的类名；通常没有注释，翻译的文本是“Anuluj”。

但事情并不总是那么简单。带有双面打印和装订设置的西班牙语版打印机对话框可能需要“Activado”和“Activada”作为“Enabled”的翻译。在这种情况下，源文本在这两种情况下都是“启用”的，上下文是对话框的类名，但是这两个项都有消除歧义的功能，例如一个是“双面打印”，另一个是“绑定”。消除歧义使译者能够为西班牙语版本选择合适的性别，并使Qt能够区分译文。

使用多种翻译

可以在一个应用程序中安装多个翻译文件。将按照安装时的相反顺序搜索翻译，因此首先搜索最新安装的翻译文件以查找翻译，然后搜索最早的翻译文件。一旦找到包含匹配字符串的翻译，搜索就会停止。

这种机制使“翻译”的选择或相对于其他翻译的优先级成为可能。只需将翻译器传递到QCoreApplication :: removeTranslator（）函数从应用程序中将其卸载，然后使用QCoreApplication :: installTranslator（）重新安装它即可。然后它将是第一个要搜索匹配字符串的翻译。

另请参见：QCoreApplication::installTranslator(), QCoreApplication::removeTranslator(), QObject::tr(), QCoreApplication::translate(), I18N Example, Hello tr() Example, Arrow Pad Example, Troll Print Example.

成员函数

QTranslator

QTranslator::QTranslator(QObject *parent = nullptr)

构造一个具有未连接到任何文件的父级的空消息文件对象。

~QTranslator

[virtual]QTranslator::~QTranslator()

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

filePath

[since 5.15]QString QTranslator::filePath() const

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

如果还没有加载翻译，或者加载失败，或者翻译没有从文件中加载，则文件路径为空。

这个函数是在Qt 5.15中引入的。

isEmpty

[virtual]bool QTranslator::isEmpty() const

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

language

[since 5.15]QString QTranslator::language() const

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

Qt5.15中引入了此函数。

load

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

加载**文件名filename+后缀suffix **（如果未指定后缀，则为“.qm”），后缀可以是绝对文件名，也可以是相对于目录的。如果成功加载翻译，则返回true；否则返回false。

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

此转换器对象以前的内容将被丢弃。

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

  • 不带后缀的文件名。
  • 去除了search_delimiters中的字符后带有文本的文件名（如果为空字符串，则search_delimiters为默认值“ _。” ）和后缀。
  • 文件名剥离，不加后缀。
  • 文件名进一步剥离，等等。

例如，在fr_CA地区(加拿大法语区)运行的应用程序可能调用load(“foo.fr_ca”， “/opt/foolib”)。然后load()将尝试打开列表中第一个现有的可读文件:

  • / opt / foolib / foo.fr_ca.qm
  • / opt / foolib / foo.fr_ca
  • / opt / foolib / foo.fr.qm
  • / opt / foolib / foo.fr
  • / opt / foolib / foo.qm
  • / opt / foolib / foo

通常，最好改用QTranslator :: load（const QLocale＆，const QString＆，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())

加载文件名+前缀+用户界面语言名称+后缀（如果未指定后缀，则为“.qm”），后缀可以是绝对文件名，也可以是相对于目录的。如果成功加载翻译，则返回true；否则返回false。

此转换器对象以前的内容将被丢弃。

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

  • 不带后缀的文件名。
  • 带有ui语言部分的文件名，在“ _”字符后加后缀。
  • ui语言部分的文件名被剥去，不附加后缀。
  • ui语言部分的文件名被进一步剥离，等等。

例如，使用以下ui语言- “es”， “fr-CA”， "de"运行的应用程序可能会调用load(QLocale()， “foo”， “.”， “/opt/foolib”， “.qm”)。load()将在ui语言中将’-’(破折号)替换为’_’(下划线)，然后尝试从这个列表中打开第一个现有的可读文件:

  • / opt / foolib / foo.es.qm
  • / opt / foolib / foo.es
  • / opt / foolib / foo.fr_CA.qm
  • / opt / foolib / foo.fr_CA
  • / opt / foolib / foo.fr.qm
  • / opt / foolib / foo.fr
  • / opt / foolib / foo.de.qm
  • / opt / foolib / foo.de
  • / opt / foolib / foo.qm
  • / opt / foolib / foo.
  • / opt / foolib / foo

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

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

这个函数重载load()。

将长度为len的QM文件数据加载到转换器中。

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

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

translate

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

返回键的翻译(上下文、sourceText、消歧)。如果没有找到，也尝试(context, sourceText， “”)。如果仍然失败，返回一个空字符串。

注意:不完整的翻译可能会导致意想不到的行为:如果没有为(context, sourceText， “”)提供翻译，在这种情况下，该方法可能实际返回不同的消歧翻译。

如果n不是-1，则使用它来选择适当的转换形式(例如:“%n文件找到”vs.“%n文件找到”文件“% n发现”)。

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

参见负载()。

OceanStar的学习笔记
关注
  • 8
    点赞
  • 踩
  • 11
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
QTranslator Class
m0_45463480的博客
05-31 1022
QTranslator 类 公共成员函数 类说明 查找翻译 使用多种翻译 成员函数使用说明
QTranslator的使用
C++ 爱好者 make_it_simple888
02-24 2093
QTranslator的使用 QTranslator类就是使用Qt的翻译文件，可以对界面中菜单栏、label、对话框等进行翻译。使用的前提是，开发者要自己创建翻译文件。 一.创建翻译文件 1.在*.pro中添加：TRANSLATIONS += *.ts，有多少种语言添加多少个文件。 2.之后运行lupdate *.pro生成ts文件。lupdate会根据源代码中的内容提取出待翻译的字段，然后生成ts文件，该文件时xml格式的 3.使用qt linguist打开ts文件，并翻译相应字段； 4.运行lr
Qt5 QTranslator使用说明
03-19
说明解决Qt5使用自带qm文件翻译Translate失败的问题，介绍如何自己根据需要创建qm文件
【QT开发】应用国际化和本地化QTranslator 类详解及实战应用
最新发布
科技改变人类，技术成就未来
07-11 973
QTranslator 是 Qt 实现应用程序国际化和本地化的重要工具，能够方便地加载和切换翻译文件。通过本文的详细介绍，您应对 QTranslator 的基本使用、高级应用技巧及相关注意事项有了全面的理解。在实际项目中，QTranslator 可以帮助实现多语言支持和动态语言切换，希望本文能帮助您更好地理解和使用 QTranslator，在各种应用场景中实现高效的国际化和本地化。
:-1: error: Cannot run compiler 'D:\qt\5.9.1\android_armv7\android-ndk-r9b-windows-x86\android-ndk-r
yushan210的博客
02-26 918
???? error: Cannot run compiler ‘D:\qt\5.9.1\android_armv7\android-ndk-r9b-windows-x86\android-ndk-r9b/toolchains/arm-linux-androideabi-4.8/prebuilt/windows/bin/arm-linux-androideabi-g++’. Maybe you forg...
QTranslator翻译器
not_give_up_的博客
06-13 1104
步骤：1.新建一个qt工程 2.在该工程的pro文件中添加 TRANSLATIONS = lang_en.ts lang_zh.ts\
Qt之QTranslator
guoyaru1992的博客
09-30 1369
创建工程 打开Qt Creator创建Qt Widgets Application工程，工程名称TestTranstor 创建要翻译的文本 1、ui界面添加要翻译的控件文本PushButton1,PushButton2 2、tr()文本 界面文本框代码添加文本 ui->lineEdit->setText(tr("this is test")); QStringList lables; lables.append(tr("property")); lables.append(tr("valu
Qt：一些Qt小项目
02-10
7. **国际化和本地化**：Qt的QTranslator和QLocale类可以帮助开发者实现应用程序的多语言支持。 在压缩包中的"Qt-main"可能是一个主程序或者主目录，其中可能包含以下内容： - **源代码**：.cpp和.h文件，展示了Qt...
qt使用QTranslator QObject::tr(“”)软件国际化
从零开始
04-22 2938
1.      程序入口处添加如下代码： QTranslatortranslator; translator.load("uav_tr_la"); qApp->installTranslator(&translator); 2.      在 *.pro中添加下行：          TRANSLATIONS=uav_tr_la.ts 3.      将界面中显
qt_translator.zip
07-02
Demo实现了Qt多语言动态切换，包含widget和qml界面。博文详见：https://blog.csdn.net/qq_35241071/article/details/107087025
Qt学习笔记之QTranslator
浩瀚之水的专栏
02-02 3593
QTranslator类为文本输出提供国际化支持。 此类的一个对象包含一组从源语言到目标语言的转换。QTranslator提供了在翻译文件中查找翻译的功能。翻译文件是使用Qt Linguist创建的。 QTranslator最常见的用法是:加载一个翻译文件，使用QCoreApplication::installTranslator()安装它，并通过QObject::tr()使用它。下面是一个使...
翻译利器QTranslate
Mungl3ean的博客
12-27 2197
文章目录翻译利器QTranslate介绍设置 翻译利器QTranslate 介绍 终于找到一款翻译神器，由于经常浏览网页使用chrome翻译插件，阅读英文pdf使用有道词典pc端，吐槽一下pc端复制粘贴经常出现问题。由于使用以上只能获得一种翻译，很多一词多义不能确定具体含义。 知乎发现了有人推荐QTranslate神器(Windows)，下载试了一下果然好用，不管是网页还是pdf都能划译，而且可以...
Qt国际化之QTranslator的使用
cslqm
02-19 4203
Qt国际化QTranslator的使用 一般使用Qt设计软件时，多采用默认英文（包括菜单、按键，对话框等）显示，再根据特定的场合使用国际化功能class，实现同一软件不同语言的功能。 类QTranslator就是实现国际化的类，而且使用方便。 一个简单粗暴的例子： QApplication a(argc, argv); QTranslator *translator =
Qt界面语言翻译QTranslator
狼群中的攻城狮
03-15 336
三步实现Qt多语言翻译，一步应用到程序
【linux】QT QTranslator 中英文翻译linguist语言家 翻译过程
Wynne的博客
11-01 2517
QT QTranslator 中英文翻译linguist语言家 翻译过程（linux）
QT 翻译
kyzb002的专栏
01-02 125
(18条消息) QT国际化(lupdate/linguits/lrelease)生成.ts，转换成.qm方法_akjw008的专栏-CSDN博客 #include "mainwindow.h" #include <QApplication> #include <QTranslator> int main(int argc, char *argv[]) { QApplication a(argc, argv); #ifdef Q_OS_LINUX .
QT QTranslator的使用
cslqm
12-03 7317
QTranslator的使用 QTranslator类就是使用Qt的翻译文件，可以对界面中菜单栏、label、对话框等进行翻译。使用的前提是，开发者要自己创建翻译文件。 一.创建翻译文件 1.在*.pro中添加：TRANSLATIONS += *.ts，有多少种语言添加多少个文件。 2.之后运行lupdate *.pro生成ts文件。lupdate会根据源代码中的内容提取出
Qtranslate翻译出现“未返回数据”怎么解决
NCTU_to_prove_safety的博客
03-13 9858
1、打开QTranslate 选项窗口 2、选择高级选项卡 3、将Google域名选项更改为cn 4、单击确定或应用 按钮以保存更改
qtranslator
07-28
QTranslator是Qt框架中的一个类，用于实现国际化和本地化功能。它可以将应用程序中的文本翻译成不同的语言。\[1\]通过使用QTranslator，可以在应用程序中加载和安装翻译文件，从而实现多语言支持。\[2\]在使用QTranslator时，可以使用load()函数加载翻译文件，并使用installTranslator()函数安装翻译器。这样，翻译器将成为应用程序中搜索匹配字符串的第一个翻译。\[2\]下面是一个使用QTranslator的main()函数示例，其中加载了一个翻译文件并将其安装到应用程序中。\[3\]通过使用QCoreApplication::translate()函数，可以将文本翻译为指定的语言。在示例中，QPushButton的文本被翻译为"Hello world!"。\[3\] #### 引用[.reference_title] - *1* [QT---之QTranslator【界面语言翻译】及QT-Linguist的用法](https://blog.csdn.net/weixin_39609623/article/details/82802666)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^insert_down1,239^v3^insert_chatgpt"}} ] [.reference_item] - *2* *3* [Qt：QTranslator类](https://blog.csdn.net/zhizhengguan/article/details/115727646)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^insert_down1,239^v3^insert_chatgpt"}} ] [.reference_item] [ .reference_list ]
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值