Ejemplo de Arrow Pad
Comprender el concepto de contextos de « Qt Linguist » y utilizar dos o más idiomas.

Utilizaremos dos traducciones, al francés y al neerlandés, aunque no existe un límite efectivo en el número de traducciones posibles que se pueden utilizar con una aplicación.
Al utilizar qmake, las líneas relevantes en arrowpad.pro son:
HEADERS = arrowpad.h \
mainwindow.h
SOURCES = arrowpad.cpp \
main.cpp \
mainwindow.cpp
TRANSLATIONS = arrowpad_fr.ts \
arrowpad_nl.tsAl utilizar CMake, las líneas relevantes en ` CMakeLists.txt ` son:
find_package(Qt6 REQUIRED COMPONENTS LinguistTools)
qt_standard_project_setup(I18N_TRANSLATED_LANGUAGES fr nl)
qt6_add_translations(arrowpad
QM_FILES_OUTPUT_VARIABLE qm_files)
install(FILES ${qm_files} DESTINATION ${INSTALL_EXAMPLEDIR})Ejecuta lupdate. Debería generar dos archivos de mensajes idénticos: arrowpad_fr.ts y arrowpad_nl.ts. Estos archivos contendrán todos los textos originales marcados para su traducción mediante las llamadas tr() y sus contextos.
Al utilizar qmake, hay que ejecutar lupdate manualmente:
lupdate arrowpad.proSi se utiliza CMake, compilar el objetivo « update_translations » para ejecutar « lupdate »:
cmake --build . --target update_translationsConsulte el manual de «Qt Linguist » para obtener más información sobre la traducción de aplicaciones Qt.
Explicación línea por línea
En arrowpad.h definimos la subclase ArrowPad, que es una subclase de QWidget. En la captura de pantalla anterior, el widget central con los cuatro botones es un ArrowPad.
class ArrowPad : public QWidget
{
Q_OBJECTCuando se ejecuta lupdate, no solo extrae los textos fuente, sino que también los agrupa en contextos. Un contexto es el nombre de la clase en la que aparece el texto fuente. Así, en este ejemplo, «ArrowPad» es un contexto: es el contexto de los textos de la clase ArrowPad. La macro Q_OBJECT define tr(x) en ArrowPad de la siguiente manera:
qApp->translate("ArrowPad", x)Saber en qué clase aparece cada texto de origen permite Qt Linguist agrupar textos que están relacionados lógicamente entre sí; por ejemplo, todo el texto de un cuadro de diálogo tendrá como contexto el nombre de la clase de dicho cuadro de diálogo y se mostrará junto con el resto del texto del cuadro de diálogo. Esto proporciona información útil para el traductor, ya que el contexto en el que aparece el texto puede influir en cómo debe traducirse. En algunas traducciones puede ser necesario modificar los atajos de teclado, y tener todos los textos de origen de un contexto concreto (clase) agrupados facilita al traductor realizar cualquier cambio en los atajos sin introducir conflictos.
En arrowpad.cpp implementamos la clase ArrowPad.
upButton = new QPushButton(tr("&Up"));
downButton = new QPushButton(tr("&Down"));
leftButton = new QPushButton(tr("&Left"));
rightButton = new QPushButton(tr("&Right"));Llamamos a ` ArrowPad::tr() ` para la etiqueta de cada botón, ya que las etiquetas son texto visible para el usuario.

class MainWindow : public QMainWindow
{
Q_OBJECTEn la captura de pantalla anterior, toda la ventana es un « MainWindow ». Esto se define en el archivo de cabecera « mainwindow.h ». Aquí también utilizamos « Q_OBJECT », de modo que « MainWindow » se convierta en un contexto en Qt Linguist.
arrowPad = new ArrowPad;En la implementación de ` MainWindow`, ` mainwindow.cpp`, creamos una instancia de nuestra clase ` ArrowPad `.
exitAct = new QAction(tr("E&xit"), this);
exitAct->setShortcut(QKeySequence(tr("Ctrl+Q", "Quit")));
connect(exitAct, &QAction::triggered, this, &MainWindow::close);También llamamos a MainWindow::tr() dos veces, una para la acción y otra para el atajo de teclado.
Fíjate en el uso de ` tr() ` para admitir diferentes teclas en otros idiomas. «Ctrl+Q» es una buena opción para «Quit» en inglés, pero un traductor neerlandés podría querer usar «Ctrl+A» (para «Afsluiten») y un traductor alemán «Strg+E» (para «Beenden»). Al utilizar tr() para los atajos de teclado de Ctrl, debe emplearse la forma de dos argumentos, en la que el segundo argumento describe la función que realiza el atajo.
Nuestra función « main() » se define en « main.cpp » como de costumbre.
QTranslator translator;
if (translator.load(locale, u"arrowpad"_s, u"_"_s))
app.installTranslator(&translator);Elegimos qué traducción utilizar en función de la configuración regional actual. Se puede influir en QLocale::system() configurando, por ejemplo, la variable de entorno LANG. Obsérvese que el uso de una convención de nomenclatura que incorpore la configuración regional para los archivos de mensajes de .qm (y los archivos TS) facilita la implementación de la elección del archivo de traducción según la configuración regional.
Si no existe ningún archivo de mensajes QM para la configuración regional seleccionada, se utilizará el texto original y no se generará ningún error.
Traducción al francés y al neerlandés
Empezaremos traduciendo la aplicación de ejemplo al francés. Inicia Qt Linguist con arrowpad_fr.ts. Deberías ver los siete textos de origen («&Up», «&Left», etc.) agrupados en dos contextos («ArrowPad» y «MainWindow»).
Ahora, introduce las siguientes traducciones:
ArrowPad- &Up - &Haut
- &Left - &Gauche
- &Right - &Droite
- &Down - &Bas
MainWindow- E&xit - &Salir
- Ctrl+Q - Ctrl+Q
- &Archivo - &Fichier
El botón « Done & Next » marca la traducción como finalizada y pasa al siguiente texto de origen. Es más rápido utilizar su atajo de teclado (véase la barra de menú «Traducción») después de escribir cada traducción.
Guarda el archivo y haz lo mismo con el neerlandés utilizando « arrowpad_nl.ts »:
ArrowPad- &Arriba - &Omhoog
- &Izquierda - &Links
- &Right - &Rechts
- &Abajo - Omlaa&g
MainWindow- E&xit - &Salir
- Ctrl+Q - Ctrl+A
- Archivo - &Bestand
Tenemos que convertir los archivos fuente de traducción tt1_fr.ts y tt1_nl.ts en archivos QM. Podríamos utilizar Qt Linguist como hemos hecho antes; sin embargo, el uso de la herramienta de línea de comandos lrelease garantiza que se creen todos los archivos QM de la aplicación sin que tengamos que acordarnos de cargar y File|Release cada uno de ellos individualmente desde Qt Linguist.
Escribe
lrelease arrowpad.proal utilizar CMake, escribe
cmake --build . --target release_translationsEsto debería crear tanto arrowpad_fr.qm como arrowpad_nl.qm.
Para utilizar arrowpad_fr.qm, cambia el idioma del sistema a francés. En Unix, cualquiera de los dos comandos siguientes debería funcionar:
export LANG=fr
setenv LANG frEn Windows o Mac, configura el idioma de la interfaz en francés.
Al ejecutar el programa, deberías ver ahora la versión en francés:

Prueba lo mismo con el neerlandés (utiliza LANG=nl en Unix). Ahora debería aparecer la versión en neerlandés:

Ejercicios
Marca una de las traducciones como Qt Linguist como «sin hacer», es decir, desmarcando la casilla «hecho»; ejecuta lupdate, luego lrelease y, a continuación, el ejemplo. ¿Qué efecto ha tenido este cambio?
Establece LANG=fr_CA (francés de Canadá) y ejecuta de nuevo el programa de ejemplo. Explica por qué el resultado es el mismo que con LANG=fr.
Cambia uno de los atajos de teclado de la traducción al neerlandés para eliminar el conflicto entre &Bestand y &Boven.
© 2026 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.