QTranslator Class

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

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein leeres Nachrichtendatei-Objekt mit übergeordnetem parent, das nicht mit einer Datei verbunden ist.

[virtual noexcept] QTranslator::~QTranslator()

Zerstört das Objekt und gibt alle zugewiesenen Ressourcen frei.

QString QTranslator::filePath() const

Gibt den Pfad der geladenen Übersetzungsdatei zurück.

Der Dateipfad ist leer, wenn noch keine Übersetzung geladen wurde, das Laden fehlgeschlagen ist oder wenn die Übersetzung nicht aus einer Datei geladen wurde.

[virtual] bool QTranslator::isEmpty() const

Gibt true zurück, wenn dieser Übersetzer leer ist, ansonsten false. Diese Funktion funktioniert mit gestrippten und nicht gestrippten Übersetzungsdateien.

QString QTranslator::language() const

Gibt die Zielsprache zurück, wie sie in der Übersetzungsdatei gespeichert ist.

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

Lädt filename + suffix (".qm", wenn suffix nicht angegeben ist), das ein absoluter Dateiname oder relativ zu directory sein kann. Gibt true zurück, wenn die Übersetzung erfolgreich geladen wurde; andernfalls wird false zurückgegeben.

Wenn directory nicht angegeben ist, wird das aktuelle Verzeichnis verwendet (d.h. wie currentPath()).

Der vorherige Inhalt dieses Übersetzungsobjekts wird verworfen.

Wenn der Dateiname nicht existiert, werden andere Dateinamen in der folgenden Reihenfolge ausprobiert:

1. Dateiname ohne angehängte suffix.
2. Dateiname ohne Text nach einem Zeichen in search_delimiters ("_." ist der Standardwert für search_delimiters, wenn es eine leere Zeichenkette ist) und suffix.
3. Dateiname ohne Anhängen von suffix.
4. Dateiname ohne weitere Zeichen, usw.

Ein Beispiel: Eine Anwendung, die im fr_CA-Locale (französischsprachiges Kanada) läuft, könnte load("foo.fr_ca", "/opt/foolib") aufrufen. load() würde dann versuchen, die erste vorhandene lesbare Datei aus dieser Liste zu öffnen:

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

Normalerweise ist es besser, stattdessen die Funktion QTranslator::load(const QLocale &, const QString &, const QString &, const QString &, const QString &) zu verwenden, weil sie QLocale::uiLanguages() und nicht einfach den Namen des Gebietsschemas verwendet, der sich auf die Formatierung von Daten und Zahlen und nicht unbedingt auf die Sprache der Benutzeroberfläche bezieht.

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

Lädt filename + prefix + ui language name + suffix (".qm", wenn suffix nicht angegeben ist), das ein absoluter Dateiname oder relativ zu directory sein kann. Gibt true zurück, wenn die Übersetzung erfolgreich geladen wurde; andernfalls wird false zurückgegeben.

Der vorherige Inhalt dieses Translator-Objekts wird verworfen.

Wenn der Dateiname nicht existiert, werden andere Dateinamen in der folgenden Reihenfolge ausprobiert:

1. Dateiname ohne angehängte suffix.
2. Dateiname mit dem ui-Sprachteil nach einem "_"-Zeichen, der entfernt wurde und suffix.
3. Dateiname ohne den ui-Sprachteil, ohne suffix angehängt.
4. Dateiname, bei dem der ui-Sprachteil weiter entfernt wurde, usw.

Zum Beispiel könnte eine Anwendung, die in locale mit den folgenden ui languages - "es", "fr-CA", "de" läuft, load(QLocale(), "foo", ".", "/opt/foolib", ".qm") aufrufen. load() würde '-' (Bindestrich) durch '_' (Unterstrich) in der Sprache der Benutzeroberfläche ersetzen und dann versuchen, die erste vorhandene lesbare Datei aus dieser Liste zu öffnen:

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

Auf Betriebssystemen, bei denen das Dateisystem zwischen Groß- und Kleinschreibung unterscheidet, versucht QTranslator auch, eine klein geschriebene Version des Gebietsschemas zu laden.

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

Diese Funktion überlastet load().

Lädt die Daten der QM-Datei data der Länge len in den Übersetzer.

Die Daten werden nicht kopiert. Der Aufrufer muss garantieren können, dass data nicht gelöscht oder verändert wird.

directory wird nur verwendet, um das Basisverzeichnis beim Laden der Abhängigkeiten einer QM-Datei anzugeben. Wenn die Datei keine Abhängigkeiten hat, wird dieses Argument ignoriert.

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

Gibt die Übersetzung für den Schlüssel (context, sourceText, disambiguation) zurück. Wenn keine gefunden wird, wird auch versucht (context, sourceText, ""). Schlägt auch dies fehl, wird ein Null-String zurückgegeben.

Wenn n nicht -1 ist, wird es verwendet, um eine geeignete Form für die Übersetzung zu wählen (z.B. "%n file found" vs. "%n files found").

Wenn Sie programmatisch Übersetzungen in eine QTranslator einfügen müssen, kann diese Funktion neu implementiert werden.

Siehe auch load().