En esta página

Internacionalización con Qt

La internacionalización y la localización de una aplicación son los procesos mediante los cuales se adapta la aplicación a diferentes idiomas, diferencias regionales y requisitos técnicos de un mercado de destino.

  • La internacionalización consiste en diseñar una aplicación de tal forma que pueda adaptarse a diversos idiomas y regiones sin necesidad de modificaciones técnicas.
  • La localización consiste en adaptar las aplicaciones internacionalizadas a una región o idioma específicos añadiendo componentes propios de la configuración regional (como los formatos de fecha, hora y números) y traduciendo el texto.

La necesidad de internacionalización abarca desde cambios ortográficos hasta permitir que la aplicación funcione en diferentes idiomas y utilice distintas técnicas de entrada, codificaciones de caracteres y convenciones de presentación.

Todos los controles de entrada y métodos de representación de texto de Qt ofrecen compatibilidad integrada con todos los idiomas admitidos. El motor de fuentes integrado representa correctamente el texto que contiene caracteres de diversos sistemas de escritura al mismo tiempo.

Para obtener más información sobreVéase
Internacionalización del código fuenteEscritura de código fuente para su traducción
Configuración e implementación de traducciones, así como el uso de traducciones existentes de módulos de QtLocalización de aplicaciones
Uso de las herramientas de traducción de QtQt Linguist Manual

El siguiente vídeo muestra cómo internacionalizar y localizar una sencilla aplicación de ejemplo:

Clases de Qt para la internacionalización

Las siguientes clases permiten la internacionalización de aplicaciones Qt.

QCollator

Compara cadenas según un algoritmo de ordenación localizado

QCollatorSortKey

Se puede utilizar para acelerar la ordenación de cadenas

QLocale

Convierte entre números y sus representaciones como cadenas en varios idiomas

QStringConverter

Clase base para la codificación y decodificación de texto

QStringDecoder

Decodificador de texto basado en estados

QStringEncoder

Codificador de texto basado en estados

QTextCodec

Conversiones entre codificaciones de texto

QTextDecoder

Decodificador basado en estados

QTextEncoder

Codificador basado en estados

QTranslator

Compatibilidad con la internacionalización para la salida de texto

Consulta «Escribir código fuente para la traducción » para obtener más información sobre cómo utilizar las clases en las aplicaciones.

Idiomas y sistemas de escritura

Qt es compatible con la mayoría de los « languages » que se utilizan en la actualidad.

Los controles de entrada, como el tipo « Qt Quick » ( TextInput ) y las clases « QLineEdit », « QTextEdit » y sus derivadas, así como los controles de visualización, como el tipo « Text » y la clase « QLabel », gestionan las siguientes características especiales de los distintos sistemas de escritura:

  • Saltos de línea

    Algunas lenguas asiáticas se escriben sin espacios entre palabras. Los saltos de línea pueden producirse después de cualquier carácter (con excepciones), como en chino, japonés y coreano, o después de los límites lógicos entre palabras, como en tailandés.

  • Escritura bidireccional

    El árabe y el hebreo se escriben de derecha a izquierda, salvo los números y el texto en inglés incrustado, que se escribe de izquierda a derecha. El comportamiento exacto se define en el Anexo Técnico n.º 9 de Unicode.

  • Marcas no espaciadoras o diacríticas, como los acentos o las diéresis en las lenguas europeas

    Algunos idiomas, como el vietnamita, hacen un uso extensivo de estos signos y algunos caracteres pueden llevar más de un signo a la vez para aclarar la pronunciación.

  • Ligaduras

    En contextos especiales, algunos pares de caracteres se sustituyen por un glifo combinado que forma una ligadura. Ejemplos comunes son las ligaduras « fl » y « fi », utilizadas en la composición tipográfica de libros estadounidenses y europeos.

El motor de texto de Qt admite diferentes ligaduras « writing systems » que funcionan en todas las plataformas siempre que estén instaladas las fuentes necesarias para representarlas.

No es necesario conocer el sistema de escritura utilizado en un idioma concreto, a menos que se desee escribir los propios controles de entrada de texto. En algunos idiomas, como el árabe o las lenguas del subcontinente indio, el ancho y la forma de un glifo varían en función de los caracteres que lo rodean. Para tener esto en cuenta en el código C++, utiliza QTextLayout. La creación de controles de entrada de texto también requiere cierto conocimiento de los alfabetos en los que se van a utilizar. Por lo general, la forma más sencilla es crear una subclase de QLineEdit o QTextEdit.

Codificación

La codificación es relevante tanto para los archivos fuente de la aplicación como para los archivos de texto que la aplicación lee o escribe.

Codificación del código fuente

Los documentos Qml siempre están codificados en formato UTF-8. Desde Qt 6, el UTF-8 de 8 bits es la codificación predominante también en Qt C++.

La herramienta lupdate extrae las cadenas de la interfaz de usuario de tu aplicación. Por defecto, espera que todo el código fuente esté codificado en UTF-8.

Sin embargo, algunos editores, como Visual Studio, utilizan una codificación diferente por defecto. Una forma de evitar problemas de codificación es limitar el código fuente a ASCII y utilizar secuencias de escape para las cadenas traducibles que contengan otros caracteres; por ejemplo:

label->setText(tr("F\374r \310lise"));

QString::toUtf8() devuelve el texto en codificación UTF-8, lo que conserva la información Unicode al tiempo que parece ASCII simple si el texto es íntegramente ASCII. Para convertir Unicode a la codificación local de 8 bits, utiliza QString::toLocal8Bit(). En sistemas Unix, esto equivale a toUtf8(). En Windows, se utiliza la página de códigos actual del sistema.

Para convertir de UTF-8 y de la codificación local de 8 bits a QString, utiliza las funciones de conveniencia QString::fromUtf8() y QString::fromLocal8Bit().

Codificación de la entrada y salida de texto

Utiliza QTextStream::setEncoding() para establecer la codificación común para los flujos de texto.

Si necesitas alguna otra codificación heredada, utiliza la clase ` QTextCodec ` del módulo `Qt5Compat`.

Cuando se inicia una aplicación, la configuración regional del equipo determina la codificación de 8 bits que se utiliza para los datos externos de 8 bits. QTextCodec::codecForLocale() devuelve un códec que puedes utilizar para convertir entre esta codificación regional y Unicode.

En ocasiones, la aplicación puede requerir una codificación distinta de la codificación local predeterminada de 8 bits. Por ejemplo, una aplicación en una configuración regional cirílica KOI8-R (la configuración regional estándar de facto en Rusia) podría necesitar generar texto cirílico en la codificación ISO 8859-5. El código para ello sería:

QString string = ...; // some Unicode text

QTextCodec *codec = QTextCodec::codecForName("ISO 8859-5");
QByteArray encodedString = codec->fromUnicode(string);

El siguiente código muestra la conversión de cirílico ISO 8859-5 a Unicode:

QByteArray encodedString = ...; // some ISO 8859-5 encoded text

QTextCodec *codec = QTextCodec::codecForName("ISO 8859-5");
QString string = codec->toUnicode(encodedString);

Para obtener una lista completa de las codificaciones compatibles, consulta la documentación de QTextCodec.

Sistemas operativos y sistemas de ventanas

Algunos de los sistemas operativos y entornos gráficos en los que se ejecuta Qt solo ofrecen una compatibilidad limitada con Unicode. El nivel de compatibilidad disponible en el sistema subyacente influye en cierta medida en la compatibilidad que Qt puede ofrecer en esas plataformas, aunque, en general, las aplicaciones Qt no tienen por qué preocuparse demasiado por las limitaciones específicas de cada plataforma.

Unix/X11

  • Qt oculta las fuentes y los métodos de entrada orientados a la configuración regional y proporciona entrada y salida Unicode.
  • La mayoría de las variantes de Unix utilizan convenciones del sistema de archivos como UTF-8 de forma predeterminada. Todas las funciones de archivos de Qt admiten Unicode, pero convierten los nombres de archivo a la codificación local de 8 bits, ya que esta es la convención de Unix.
  • La E/S de archivos utiliza por defecto la codificación local de 8 bits, con opciones Unicode en ` QTextStream`.
  • Algunas distribuciones antiguas de Unix solo ofrecen compatibilidad parcial con ciertas configuraciones regionales. Por ejemplo, aunque tengas un directorio /usr/share/locale/ja_JP.EUC, no podrás mostrar texto en japonés a menos que instales fuentes japonesas y el directorio esté completo. Para obtener los mejores resultados, utiliza configuraciones regionales completas proporcionadas por el proveedor de tu sistema.

Linux

  • Qt ofrece compatibilidad total con Unicode, incluidos los métodos de entrada, las fuentes, el portapapeles y la función de arrastrar y soltar.
  • El sistema de archivos está codificado en UTF-8 en todas las distribuciones modernas de Linux. La E/S de archivos utiliza UTF-8 de forma predeterminada.

Windows

  • Qt ofrece compatibilidad total con Unicode, incluyendo métodos de entrada, fuentes, portapapeles, arrastrar y soltar, y nombres de archivo.
  • La E/S de archivos utiliza por defecto Latin1, con opciones Unicode en QTextStream. Sin embargo, algunos programas de Windows no reconocen los archivos de texto Unicode en formato «big-endian», a pesar de que ese es el orden prescrito por el estándar Unicode en ausencia de protocolos de nivel superior.

Localizing Applications

Localización de aplicaciones Qt y de Qt Quick a varios idiomas.

Meta strings reference

Guía de referencia para las metacadenas utilizadas en el sistema de traducción de Qt

Qt Linguist Examples

Uso de Qt Linguist para internacionalizar tu aplicación Qt

Qt Linguist Manual

Uso de las herramientas de traducción de Qt: lupdate, lrelease y Qt Linguist

Text ID based translations

La internacionalización basada en Text ID ofrece soporte para proyectos a gran escala con numerosas configuraciones regionales de destino y gran cantidad de textos que traducir

Translation Rules for Plural Forms

Resumen de las reglas de traducción para las formas plurales generadas por las herramientas de traducción de Qt.

Writing Source Code for Translation

Cómo escribir código fuente que permita la localización de aplicaciones.

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