Exemple de Hello tr()
Traduction d'un petit programme Hello World en latin.
La capture d'écran montre la version anglaise.

Voir le manuelQt Linguist pour plus d'informations sur la traduction des applications Qt.
Cheminement ligne par ligne
#include <QTranslator>Cette ligne inclut la définition de la classe QTranslator. Les objets de cette classe fournissent des traductions pour le texte visible par l'utilisateur.
QTranslator translator;Crée un objet QTranslator sans parent.
Q_UNUSED(translator.load("hellotr_la"));
Tente de charger un fichier appelé hellotr_la.qm (l'extension de fichier .qm est implicite) qui contient les traductions latines des textes sources utilisés dans le programme. Aucune erreur ne se produit si le fichier n'est pas trouvé. Cet exemple fonctionne mieux sur les plateformes de bureau. Sur des plateformes comme Android et iOS, le fichier .qm doit faire partie de l'ensemble d'applications. En général, cela implique de regrouper le fichier .qm dans une ressource Qt.
app.installTranslator(&translator);
Ajoute les traductions de hellotr_la.qm au pool de traductions utilisé par le programme.
QPushButton hello(QPushButton::tr("Hello world!"));
Crée un bouton poussoir qui affiche "Hello world !". Si hellotr_la.qm a été trouvé et contient une traduction pour "Hello world !", la traduction apparaît ; sinon, le texte source apparaît.
Toutes les classes qui héritent de QObject ont une fonction tr(). À l'intérieur d'une fonction membre d'une classe QObject, nous écrivons simplement tr("Hello world!") au lieu de QPushButton::tr("Hello world!") ou QObject::tr("Hello world!").
Exécution de l'application en anglais
Comme nous n'avons pas créé le fichier de traduction hellotr_la.qm, le texte source s'affiche lorsque nous exécutons l'application :

Création d'un fichier de messages en latin
La première étape consiste à créer un fichier de projet qui répertorie tous les fichiers sources du projet.
Lorsque l'on utilise qmake, les lignes pertinentes dans hellotr.pro sont les suivantes :
SOURCES = main.cpp TRANSLATIONS = hellotr_la.ts
TRANSLATIONS spécifie les fichiers de messages que nous voulons maintenir. Dans cet exemple, nous ne maintenons qu'un seul ensemble de traductions, à savoir le latin.
Si vous utilisez CMake, les lignes correspondantes dans CMakeLists.txt sont: :
find_package(Qt6 REQUIRED COMPONENTS LinguistTools)
qt_standard_project_setup(I18N_TRANSLATED_LANGUAGES la)
qt6_add_translations(hellotr
QM_FILES_OUTPUT_VARIABLE qm_files)
install(FILES ${qm_files} DESTINATION ${INSTALL_EXAMPLEDIR})Notez que l'extension du fichier est .ts, et non .qm. Le format de source de traduction .ts est conçu pour être utilisé pendant le développement de l'application. Les programmeurs ou les gestionnaires de versions exécutent le programme lupdate pour générer et mettre à jour les fichiers TS avec le texte source extrait du code source. Les traducteurs lisent et mettent à jour les fichiers TS en Qt Linguist en ajoutant et en modifiant leurs traductions.
Le format TS est un XML lisible par l'homme qui peut être envoyé directement par courrier électronique et qui est facile à placer sous contrôle de version. Si vous éditez ce fichier manuellement, sachez que l'encodage par défaut du XML est UTF-8, et non Latin1 (ISO 8859-1). Une façon de saisir un caractère Latin1 tel que 'ø' (o norvégien avec barre oblique) est d'utiliser une entité XML : "ø ;". Cela fonctionne pour tous les caractères Unicode 4.0.
Une fois les traductions terminées, le programme lrelease est utilisé pour convertir les fichiers TS au format de fichier de message QM Qt. Le format QM est un format binaire compact conçu pour offrir des performances de recherche très rapides. Les programmes lupdate et lrelease lisent tous les fichiers source et d'en-tête du projet (comme spécifié dans les lignes HEADERS et SOURCES du fichier de projet) et extraient les chaînes de caractères qui apparaissent dans les appels de fonction de tr().
lupdate est utilisé pour créer et mettre à jour les fichiers de messages (hellotr_la.ts dans ce cas) afin de les maintenir synchronisés avec le code source. Il est possible d'exécuter lupdate à tout moment, car lupdate ne supprime aucune information.
Essayez d'exécuter lupdate maintenant.
Lorsque vous utilisez qmake, lupdate doit être exécuté manuellement :
lupdate -verbose hellotr.pro
(L'option -verbose demande à lupdate d'afficher des messages expliquant ce qu'il fait).
Si vous utilisez CMake, construisez la cible update_translations pour exécuter lupdate:
cmake --build . --target update_translations
Vous devriez maintenant avoir un fichier hellotr_la.ts dans le répertoire source, contenant ceci :
<!DOCTYPE TS><TS> <context> <name>QPushButton</name> <message> <source>Hello world!</source> <translation type="unfinished"></translation> </message> </context> </TS>
Vous n'avez pas besoin de comprendre le format du fichier puisqu'il est lu et mis à jour à l'aide d'outils (lupdate, Qt Linguist, lrelease).
Traduire en latin avec Qt Linguist
Nous utiliserons Qt Linguist pour fournir la traduction, bien que vous puissiez utiliser n'importe quel éditeur XML ou de texte brut pour saisir une traduction dans un fichier TS.
Pour commencer Qt Linguisttapez
linguist hellotr_la.tsVous devriez maintenant voir le texte "QPushButton" dans le panneau supérieur gauche. Double-cliquez dessus, puis cliquez sur "Hello world !" et entrez "Orbis, te saluto !" dans le volet Translation (au milieu à droite de la fenêtre). N'oubliez pas le point d'exclamation !
Cliquez sur la case Done et choisissez File|Save dans la barre de menu. Le fichier TS ne contiendra plus
<translation type='unfinished'></translation>
mais à la place, il y aura
<translation>Orbis, te saluto!</translation>
Exécution de l'application en latin
Pour voir l'application fonctionner en latin, nous devons générer un fichier QM à partir du fichier TS. La génération d'un fichier QM peut se faire soit à partir de Qt Linguist (pour un seul fichier TS), soit en utilisant le programme en ligne de commande lrelease qui produira un fichier QM pour chacun des fichiers TS listés dans le fichier de projet. Générer hellotr_la.qm à partir de hellotr_la.ts en choisissant File|Release dans la barre de menu de Qt Linguistet en appuyant sur Save dans la boîte de dialogue d'enregistrement de fichier qui s'affiche. Exécutez à nouveau le programme hellotr. Cette fois, le bouton sera intitulé "Orbis, te saluto !".

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.