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

Dokumentation der Member-Funktionen

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

Erstellt ein leeres Nachrichten-Dateiobjekt mit dem übergeordneten Objekt „ parent “, das mit keiner Datei verknüpft ist.

[virtual noexcept] QTranslator::~QTranslator()

Löscht 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 die Übersetzung nicht aus einer Datei geladen wurde.

[virtual] bool QTranslator::isEmpty() const

Gibt „ true “ zurück, wenn dieser Übersetzer leer ist, andernfalls „ false “.

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), wobei es sich um einen absoluten Dateinamen oder einen relativen Pfad zu directory handeln 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. als „ currentPath(+)“).

Der bisherige Inhalt dieses Übersetzerobjekts wird verworfen.

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

1. Dateiname ohne angehängtes „ suffix “.
2. Dateiname, bei dem der Text nach einem Zeichen in „ search_delimiters “ entfernt wurde („_.“ ist der Standardwert für „ search_delimiters “, wenn es sich um eine leere Zeichenkette handelt) und „ suffix “.
3. Dateiname ohne angehängtes „ suffix “ entfernt.
4. Der Dateiname wird weiter gekürzt usw.

Beispielsweise könnte eine Anwendung, die in der Locale „fr_CA“ (französischsprachiges Kanada) läuft, 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

In der Regel ist es besser, stattdessen die Funktion `QTranslator::load(const QLocale &, const QString &, const QString &, const QString &, const QString &)` zu verwenden, da diese ` QLocale::uiLanguages()` nutzt und nicht einfach den Locale-Namen, der sich auf die Formatierung von Datumsangaben und Zahlen bezieht und nicht unbedingt auf die Sprache der Benutzeroberfläche.

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 (mit der Endung „.qm“, wenn der suffix nicht angegeben ist), wobei es sich um einen absoluten Dateinamen oder einen relativen Pfad zu directory handeln kann. Gibt true zurück, wenn die Übersetzung erfolgreich geladen wurde; andernfalls wird false zurückgegeben.

Der bisherige Inhalt dieses Übersetzerobjekts wird verworfen.

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

1. Dateiname ohne angehängtes „ suffix “.
2. Dateiname, bei dem der Teil der UI-Sprache nach dem Zeichen „_“ entfernt wurde, sowie „ suffix “.
3. Dateiname, bei dem der UI-Sprachteil entfernt wurde, ohne dass „ suffix “ angehängt wurde.
4. Dateiname, bei dem der UI-Sprachteil weiter entfernt wurde, usw.

Beispielsweise könnte eine Anwendung, die in der locale mit den folgenden ui languages – „es“, „fr-CA“, „de“ – ausgeführt wird, load(QLocale(), „foo“, „.“, „/opt/foolib“, „.qm“) aufrufen. load() würde das „-“ (Bindestrich) in der UI-Sprache durch „_“ (Unterstrich) 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 “ außerdem, eine Version des Locale-Namens in Kleinbuchstaben zu laden.

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

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

Die Daten werden nicht kopiert. Der Aufrufer muss gewährleisten 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. Wird keine gefunden, werden auch (context, sourceText, "") versucht. Schlägt dies ebenfalls fehl, wird eine leere Zeichenkette zurückgegeben.

Ist n nicht -1, wird dieser Wert verwendet, um eine geeignete Form für die Übersetzung auszuwählen (z. B. „%n Datei gefunden“ vs. „%n Dateien gefunden“).

Wenn Sie Übersetzungen programmgesteuert in ein ` QTranslator` einfügen müssen, kann diese Funktion neu implementiert werden.

Hinweis: Diese Funktion ist threadsicher.

Siehe auch load().