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();
}

Documentation des fonctions membres

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

Crée un objet de fichier de messages vide dont l'parent parent n'est associé à aucun fichier.

[virtual noexcept] QTranslator::~QTranslator()

Détruit l'objet et libère toutes les ressources allouées.

QString QTranslator::filePath() const

Renvoie le chemin d'accès du fichier de traduction chargé.

Le chemin d'accès au fichier est vide si aucune traduction n'a encore été chargée, si le chargement a échoué ou si la traduction n'a pas été chargée à partir d'un fichier.

[virtual] bool QTranslator::isEmpty() const

Renvoie « true » si ce traducteur est vide, sinon renvoie « false ».

QString QTranslator::language() const

Renvoie la langue cible telle qu'elle est enregistrée dans le fichier de traduction.

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

Charge filename + suffix (".qm" si l'suffix n'est pas spécifiée), qui peut être un nom de fichier absolu ou relatif à directory. Renvoie true si la traduction est chargée avec succès ; sinon, renvoie false.

Si directory n’est pas spécifié, le répertoire courant est utilisé (c’est-à-dire sous la forme currentPath()).

Le contenu précédent de cet objet traducteur est supprimé.

Si le nom de fichier n'existe pas, d'autres noms de fichiers sont essayés dans l'ordre suivant :

1. Nom de fichier sans « suffix » ajouté à la fin.
2. Nom de fichier dont le texte situé après un caractère de search_delimiters a été supprimé (« _. » est la valeur par défaut pour search_delimiters s’il s’agit d’une chaîne vide) et suffix.
3. Nom de fichier sans l’ suffix.
4. Nom de fichier encore plus raccourci, etc.

Par exemple, une application s'exécutant dans la locale fr_CA (Canada francophone) pourrait appeler load("foo.fr_ca", "/opt/foolib"). La fonction load() tenterait alors d'ouvrir le premier fichier lisible existant de cette liste :

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

En général, il est préférable d’utiliser à la place la fonction QTranslator::load(const QLocale &, const QString &, const QString &, const QString &, const QString &), car elle utilise QLocale::uiLanguages() et non pas simplement le nom de la locale, qui fait référence au formatage des dates et des nombres et pas nécessairement à la langue de l’interface utilisateur.

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

Charge filename + prefix + ui language name + suffix (avec l'extension « .qm » si l'suffix n'est pas spécifiée), qui peut être un nom de fichier absolu ou relatif à directory. Renvoie true si la traduction est chargée avec succès ; sinon, renvoie false.

Le contenu précédent de cet objet traducteur est ignoré.

Si le nom de fichier n’existe pas, d’autres noms de fichiers sont essayés dans l’ordre suivant :

1. Nom de fichier sans l’extension « suffix ».
2. Nom de fichier dont la partie correspondant à la langue de l'interface, située après le caractère « _ », a été supprimée, suivi de « suffix ».
3. Nom de fichier dont la partie relative à la langue de l’interface a été supprimée, sans ajout de « suffix ».
4. Nom de fichier dont la partie relative à la langue de l'interface utilisateur a été supprimée davantage, etc.

Par exemple, une application s'exécutant dans l'locale avec l'ui languages e suivante : « es », « fr-CA », « de » pourrait appeler load(QLocale(), « foo », « . », « /opt/foolib », « .qm »). La fonction load() remplacerait le « - » (tiret) par un « _ » (trait de soulignement) dans la langue de l’interface utilisateur, puis tenterait d’ouvrir le premier fichier lisible existant de cette liste :

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

Sur les systèmes d’exploitation où le système de fichiers est sensible à la casse, la fonction ` QTranslator ` tente également de charger une version en minuscules du nom de la locale.

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

Charge les données du fichier QM data, d'une longueur de len, dans le traducteur.

Les données ne sont pas copiées. L’appelant doit pouvoir garantir que le fichier data ne sera ni supprimé ni modifié.

directory est uniquement utilisé pour spécifier le répertoire de base lors du chargement des dépendances d’un fichier QM. Si le fichier ne comporte pas de dépendances, cet argument est ignoré.

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

Renvoie la traduction correspondant à la clé (context, sourceText, disambiguation). Si aucune traduction n'est trouvée, la fonction tente également (context, sourceText, ""). Si cela échoue également, elle renvoie une chaîne vide.

Si n n’est pas égal à -1, il est utilisé pour choisir une forme appropriée pour la traduction (par exemple « %n fichier trouvé » ou « %n fichiers trouvés »).

Si vous avez besoin d’insérer des traductions par programmation dans un objet ` QTranslator`, cette fonction peut être réimplémentée.

Remarque : cette fonction est sûre pour les threads.

Voir aussi load().