QTranslator Class

// Required for using the '_L1' string literal.
using namespace Qt::StringLiterals;

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

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

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

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

Documentación de las funciones miembro

[explicit] QTranslator::QTranslator(QObject *parent = nullptr)

Construye un objeto de archivo de mensajes vacío con el padre parent que no está conectado a ningún archivo.

[virtual noexcept] QTranslator::~QTranslator()

Destruye el objeto y libera los recursos asignados.

QString QTranslator::filePath() const

Devuelve la ruta del archivo de traducción cargado.

La ruta del archivo está vacía si aún no se ha cargado ninguna traducción, si la carga ha fallado o si la traducción no se ha cargado desde un archivo.

[virtual] bool QTranslator::isEmpty() const

Devuelve true si este traductor está vacío, en caso contrario devuelve false.

QString QTranslator::language() const

Devuelve el idioma de destino almacenado en el archivo de traducción.

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

Carga filename + suffix (".qm" si no se especifica suffix ), que puede ser un nombre de archivo absoluto o relativo a directory. Devuelve true si la traducción se ha cargado correctamente; en caso contrario, devuelve false.

Si no se especifica directory, se utiliza el directorio actual (es decir, como currentPath()).

Se descarta el contenido anterior de este objeto traductor.

Si el nombre de archivo no existe, se prueban otros nombres de archivo en el siguiente orden:

1. Nombre de archivo sin suffix añadido.
2. Nombre de archivo con el texto después de un carácter en search_delimiters eliminado ("_." es el valor predeterminado para search_delimiters si es una cadena vacía) y suffix.
3. El nombre del archivo se elimina sin añadir suffix.
4. El nombre del archivo se elimina aún más, etc.

Por ejemplo, una aplicación que se ejecute en la configuración regional fr_CA (Canadá francófono) podría llamar a load("foo.fr_ca", "/opt/foolib"). load() intentaría abrir el primer archivo legible de la lista:

1. /opt/foolib/foo.fr_ca.qm
2. /opt/foolib/foo.fr_ca
3. /opt/foolib/foo.fr.qm
4. /opt/foolib/foo.fr
5. /opt/foolib/foo.qm
6. /opt/foolib/foo

Normalmente, es mejor utilizar la función QTranslator::load(const QLocale &, const QString &, const QString &, const QString &, const QString &), porque utiliza QLocale::uiLanguages() y no simplemente el nombre de la localización, que se refiere al formato de fechas y números y no necesariamente al idioma de la interfaz de usuario.

bool QTranslator::load(const QLocale &locale, const QString &filename, const QString &prefix = QString(), const QString &directory = QString(), const QString &suffix = QString())

Carga filename + prefix + ui language name + suffix (".qm" si no se especifica suffix ), que puede ser un nombre de archivo absoluto o relativo a directory. Devuelve true si la traducción se ha cargado correctamente; en caso contrario, devuelve false.

El contenido anterior de este objeto traductor se descarta.

Si el nombre de archivo no existe, se prueban otros nombres de archivo en el siguiente orden:

1. Nombre de archivo sin suffix añadido.
2. Nombre de archivo con la parte del idioma ui después del carácter "_" eliminada y suffix.
3. Nombre de archivo con la parte del idioma de la interfaz de usuario eliminada y sin suffix.
4. Nombre de archivo con la parte del idioma ui eliminada, etc.

Por ejemplo, una aplicación que se ejecute en locale con los siguientes ui languages - "es", "fr-CA", "de" podría llamar a load(QLocale(), "foo", ".", "/opt/foolib", ".qm"). load() sustituiría '-' (guión) por '_' (guión bajo) en el idioma ui y luego intentaría abrir el primer archivo legible existente de esta lista:

1. /opt/foolib/foo.es.qm
2. /opt/foolib/foo.es
3. /opt/foolib/foo.fr_CA.qm
4. /opt/foolib/foo.fr_CA
5. /opt/foolib/foo.fr.qm
6. /opt/foolib/foo.fr
7. /opt/foolib/foo.de.qm
8. /opt/foolib/foo.de
9. /opt/foolib/foo.qm
10. /opt/foolib/foo.
11. /opt/foolib/foo

En los sistemas operativos en los que el sistema de archivos distingue entre mayúsculas y minúsculas, QTranslator también intenta cargar una versión en minúsculas del nombre de la configuración regional.

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

Carga los datos del archivo QM data de longitud len en el traductor.

Los datos no se copian. La persona que llama debe poder garantizar que data no se borrará ni modificará.

directory sólo se utiliza para especificar el directorio base cuando se cargan las dependencias de un archivo QM. Si el archivo no tiene dependencias, este argumento se ignora.

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

Devuelve la traducción de la clave (context, sourceText, disambiguation). Si no se encuentra ninguna, prueba también (context, sourceText, ""). Si aún así falla, devuelve una cadena nula.

Si n no es -1, se utiliza para elegir una forma adecuada para la traducción (por ejemplo, "%n archivo encontrado" frente a "%n archivos encontrados").

Si necesita insertar mediante programación traducciones en QTranslator, puede reimplementar esta función.

Nota: Esta función es thread-safe.

Véase también load().