En esta página

Ejemplo de impresión de Troll

Actualización de traducciones para futuras versiones.

Troll Print es una aplicación de ejemplo que permite al usuario elegir la configuración de la impresora. Está disponible en dos versiones: inglés y portugués.

Captura de pantalla en la que se muestra la interfaz de usuario del ejemplo «Troll Print» en inglés

Hemos incluido un archivo de traducción, trollprint_pt.ts, que contiene algunas traducciones al portugués para este ejemplo.

Consideraremos dos versiones de la misma aplicación: Troll Print 1.0 y 1.1. Aprenderemos a reutilizar las traducciones creadas para una versión en una versión posterior. (En este tutorial, tendrás que editar algunos archivos fuente. Probablemente lo mejor sea copiar todos los archivos a un nuevo directorio temporal y trabajar desde allí).

Consulta el manual deQt Linguist para obtener más información sobre cómo traducir aplicaciones Qt.

Explicación paso a paso

La clase ` PrintPanel ` se define en ` printpanel.h`.

class PrintPanel : public QWidget
{
    Q_OBJECT

PrintPanel es un ` QWidget`. Necesita la macro ` Q_OBJECT ` para que ` tr() ` funcione correctamente.

El archivo de implementación es printpanel.cpp.

PrintPanel::PrintPanel(QWidget *parent)
    : QWidget(parent)
{
/*
    QLabel *label = new QLabel(tr("<b>TROLL PRINT</b>"));
    label->setAlignment(Qt::AlignCenter);
*/

Parte del código está comentado en Troll Print 1.0; lo descomentarás más adelante, para Troll Print 1.1.

    twoSidedGroupBox = new QGroupBox(tr("2-sided"));
    twoSidedEnabledRadio = new QRadioButton(tr("Enabled"));
    twoSidedDisabledRadio = new QRadioButton(tr("Disabled"));
    twoSidedDisabledRadio->setChecked(true);

    colorsGroupBox = new QGroupBox(tr("Colors"));
    colorsEnabledRadio = new QRadioButton(tr("Enabled"));
    colorsDisabledRadio = new QRadioButton(tr("Disabled"));

Fíjate en las dos apariciones de tr("Enabled") y de tr("Disabled") en PrintPanel. Dado que tanto «Enabled» como «Disabled» aparecen en el mismo contexto Qt Linguist solo mostrará una aparición de cada uno y utilizará las mismas traducciones para los duplicados que no muestre. Aunque esto supone un ahorro de tiempo muy útil, en algunos idiomas, como el portugués, la segunda aparición requiere una traducción independiente. Veremos cómo Qt Linguist se puede hacer para que se muestren todas las apariciones y se traduzcan por separado.

El archivo de encabezado de MainWindow, mainwindow.h, no presenta sorpresas. En la implementación, mainwindow.cpp, tenemos algunos textos fuente visibles para el usuario que deben marcarse para su traducción.

    setWindowTitle(tr("Troll Print %1").arg(version));

Debemos traducir el título de la ventana.

void MainWindow::createActions()
{
    exitAct = new QAction(tr("E&xit"), this);
    exitAct->setShortcut(tr("Ctrl+Q", "Quit"));
    connect(exitAct, &QAction::triggered, this, &MainWindow::close);

    aboutAct = new QAction(tr("&About"), this);
    aboutAct->setShortcut(Qt::Key_F1);
    connect(aboutAct, &QAction::triggered, this, &MainWindow::about);

    aboutQtAct = new QAction(tr("About &Qt"), this);
    connect(aboutQtAct, &QAction::triggered, qApp, &QApplication::aboutQt);
}

void MainWindow::createMenus()
{
    QMenu *fileMenu = menuBar()->addMenu(tr("&File"));
    fileMenu->addAction(exitAct);

    menuBar()->addSeparator();

    QMenu *helpMenu = menuBar()->addMenu(tr("&Help"));
    helpMenu->addAction(aboutAct);
    helpMenu->addAction(aboutQtAct);
}

También tenemos que traducir las acciones y los menús. Ten en cuenta que la forma de dos argumentos de ` tr() ` se utiliza para el atajo de teclado «Ctrl+Q», ya que el segundo argumento es la única pista que tiene el traductor para indicar qué función realizará ese atajo.

    QTranslator translator;
    if (translator.load(locale, u"trollprint"_s, u"_"_s))
        app.installTranslator(&translator);

La función ` main() ` de main.cpp es la misma que la del ejemplo «Arrow Pad ». En concreto, selecciona un archivo de traducción en función de la configuración regional actual.

Ejecutar Troll Print 1.0 en inglés y en portugués

Utilizaremos las traducciones del archivo trollprint_pt.ts que se proporciona.

Establece la variable de entorno LANG en pt y, a continuación, ejecuta trollprint. Deberías seguir viendo la versión en inglés. Ahora ejecuta lrelease, por ejemplo, lrelease trollprint.pro, y vuelve a ejecutar el ejemplo. Ahora deberías ver la versión en portugués (Troll Imprimir 1.0):

Captura de pantalla en la que se muestra la interfaz de usuario de «Troll Print» en portugués

Aunque la traducción se ha mostrado correctamente, en realidad es errónea. En buen portugués, la segunda aparición de «Enabled» debería ser «Ativadas», no «Ativado», y la terminación de la segunda traducción de «Disabled» también debe cambiarse de forma similar.

Si abres trollprint_pt.ts utilizando Qt Linguist, verás que solo hay una aparición de «Enabled» y de «Disabled» en el archivo fuente de traducción, aunque haya dos de cada una en el código fuente. Esto se debe a que Qt Linguist intenta minimizar el trabajo del traductor utilizando la misma traducción para los textos de origen duplicados. En casos como este, en los que una traducción idéntica es incorrecta, el programador debe resolver la ambigüedad de las apariciones duplicadas. Esto se consigue fácilmente utilizando la forma de dos argumentos de tr().

Podemos determinar fácilmente qué archivo hay que modificar, ya que el «contexto» del traductor es, de hecho, el nombre de la clase en la que aparecen los textos que deben modificarse. En este caso, el archivo es printpanel.cpp, donde hay cuatro líneas que cambiar. Añade el segundo argumento «two-sided» en las llamadas adecuadas a tr() correspondientes al primer par de botones de opción:

twoSidedEnabledRadio = new QRadioButton(tr("Enabled", "two-sided"));
twoSidedDisabledRadio = new QRadioButton(tr("Disabled", "two-sided"));

y añade el segundo argumento «colors» en las llamadas correspondientes a tr() para el segundo par de botones de opción:

colorsEnabledRadio = new QRadioButton(tr("Enabled", "colors"), colors);
colorsDisabledRadio = new QRadioButton(tr("Disabled", "colors"), colors);

Ahora vuelve a compilar, ejecuta lupdate y abre trollprint_pt.ts con Qt Linguist. Ahora deberías ver dos cambios.

En primer lugar, el archivo fuente de traducción contiene ahora tres pares «Enabled», «Disabled». El primer par está marcado con «(obs.)», lo que significa que están obsoletos. Esto se debe a que estos textos aparecían en llamadas a tr() que han sido sustituidas por nuevas llamadas con dos argumentos. El segundo par tiene «two-sided» como comentario, y el tercer par tiene «colors» como comentario. Los comentarios se muestran en el área Source text and comments en Qt Linguist.

En segundo lugar, los textos de traducción «Ativado» y «Desativado» se han utilizado automáticamente como traducciones para los nuevos textos «Enabled» y «Disabled», de nuevo para minimizar el trabajo del traductor. Por supuesto, en este caso no son correctos para la segunda aparición de cada palabra, pero constituyen un buen punto de partida.

Cambia el segundo «Ativado» por «Ativadas» y el segundo «Desativado» por «Desativadas»; a continuación, guarda y sal. Ejecuta lrelease para obtener un archivo binario trollprint_pt.qm actualizado y ejecuta Troll Print (o, mejor dicho, Troll Imprimir).

Captura de pantalla en la que se ve la impresión del troll en portugués

El segundo argumento de la llamada a tr(), denominado «comentarios» en Qt Linguist, permite distinguir entre textos de origen idénticos que aparecen en el mismo contexto (clase). También resultan útiles en otros casos para dar pistas al traductor y, en el caso de los atajos con la tecla Ctrl, son el único medio de comunicar al traductor la función que realiza dicho atajo.

Otra forma de ayudar al traductor es proporcionar información sobre cómo navegar hasta la parte concreta de la aplicación que contiene los textos de origen que debe traducir. Esto le ayuda a ver el contexto en el que aparece la traducción y también le facilita encontrar y probar las traducciones. Esto se puede lograr utilizando un comentario « TRANSLATOR » en el código fuente:

/*
   TRANSLATOR MainWindow

   In this application the whole application is a MainWindow.
   Choose Help|About from the menu bar to see some text
   belonging to MainWindow.

   ...
*/

Intenta añadir estos comentarios a algunos archivos fuente, especialmente a las clases de diálogo, describiendo la navegación necesaria para llegar a los diálogos. También podrías añadirlos a los archivos de ejemplo; por ejemplo, mainwindow.cpp y printpanel.cpp son archivos adecuados. Ejecuta lupdate y, a continuación, inicia Qt Linguist y carga trollprint_pt.ts. Deberías ver los comentarios en el área Source text and comments mientras navegas por la lista de textos fuente.

A veces, sobre todo con programas grandes, al traductor le puede resultar difícil encontrar sus traducciones y comprobar que sean correctas. Los comentarios que proporcionan buena información de navegación pueden ahorrarle tiempo:

/*
   TRANSLATOR ZClientErrorDialog

   Choose Client|Edit to reach the Client Edit dialog, then choose
   Client Specification from the drop down list at the top and pick
   client Bartel Leendert van der Waerden. Now check the Profile
   checkbox and then click the Start Processing button. You should
   now see a pop up window with the text "Error: Name too long!".
   This window is a ZClientErrorDialog.
*/

Troll Print 1.1

Ahora prepararemos la versión 1.1 de Troll Print. Abre tu editor de texto favorito y sigue estos pasos:

  • Descomenta las dos líneas que crean un archivo « QLabel » con el texto «<b>TROLL PRINT</b>» en « printpanel.cpp ».
  • Corrección de texto: Sustituye «2-sided» por «Two-sided» en printpanel.cpp.
  • Sustituye «1.0» por «1.1» en todas las ocasiones en que aparezca en mainwindow.cpp.
  • Actualizar el año de copyright a 1999-2000 en mainwindow.cpp.

(Por supuesto, en una aplicación real, el número de versión y el año de copyright serían constantes o #defines).

Una vez terminado, ejecuta lupdate y, a continuación, abre trollprint_pt.ts en Qt Linguist. Los siguientes elementos revisten especial interés:

  • PrintPanel
    • A doble cara: marcado como «(obs.)», obsoleto
    • <b>TROLL PRINT</b> — sin marcar, es decir, sin traducir
    • A doble cara: sin marcar, es decir, sin traducir.

Para facilitar las revisiones, en lugar de tr("Troll Print 1.0"), puedes utilizar tr("Troll Print %1").arg("1.0") o algo similar, para evitar tener que actualizar la cadena en cada lanzamiento.

Revisa las traducciones en MainWindow y márcalas como «hechas». Traduce «<b>TROLL PRINT</b>» como «<b>TROLL IMPRIMIR</b>». Cuando traduzcas «A doble cara», pulsa el botón Guess Again para traducir «A doble cara», pero cambia el «2» por «Dois».

Guarda y sal, y luego ejecuta lrelease. La versión en portugués debería tener este aspecto:

Captura de pantalla en la que se ve la impresión del troll en portugués

Selecciona « Ajuda|Sobre » (Help|About) para ver el cuadro de información.

Si seleccionas « Ajuda|Sobre Qt » (Help|About Qt), aparecerá un cuadro de diálogo en inglés. ¡Vaya! El propio Qt necesita ser traducido. Consulta «Internacionalización con Qt» para obtener más detalles.

Ahora configura « LANG=en » para obtener la versión original en inglés:

Captura de pantalla en la que se ve la impresión del troll en inglés

Proyecto de ejemplo en code.qt.io

© 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.