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

メンバ関数のドキュメント

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

親がparent で、どのファイルにも接続されていない空のメッセージファイルオブジェクトを作成します。

[virtual noexcept] QTranslator::~QTranslator()

オブジェクトを破棄し、割り当てられたリソースをすべて解放します。

QString QTranslator::filePath() const

読み込まれた翻訳ファイルのパスを返します。

まだ翻訳が読み込まれていない場合、読み込みに失敗した場合、またはファイルから翻訳が読み込まれなかった場合は、ファイルパスは空になります。

[virtual] bool QTranslator::isEmpty() const

このトランスレータが空の場合は `true ` を返し、それ以外の場合は `false` を返します。

QString QTranslator::language() const

翻訳ファイルに保存されている対象言語を返します。

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

filename およびsuffix （suffix が指定されていない場合は ".qm"）を読み込みます。これらは絶対ファイル名でも、directory からの相対パスでも構いません。翻訳が正常に読み込まれた場合はtrue を返し、そうでない場合はfalse を返します。

directory が指定されていない場合は、現在のディレクトリが使用されます（つまり、currentPath()として扱われます）。

このトランスレータオブジェクトの以前の内容は破棄されます。

ファイル名が存在しない場合、以下の順序で他のファイル名が試されます。

1. suffix を付加していないファイル名。
2. search_delimiters の末尾に付加された文字以降のテキストを削除したファイル名（空文字列の場合、search_delimiters ではデフォルトで「_.」が使用されます）およびsuffix 。
3. 「suffix 」が追加されていない状態で、ファイル名から不要な部分を削除したもの。
4. さらにファイル名から文字列を削除するなど。

たとえば、fr_CA ロケール（フランス語圏のカナダ）で実行されているアプリケーションが、load("foo.fr_ca", "/opt/foolib") を呼び出す場合、load() はこのリストから最初に存在する読み取り可能なファイルを開こうとします：

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

通常は、代わりに QTranslator::load(constQLocale &, constQString &, constQString &, constQString &, constQString &) 関数を使用することをお勧めします。これは、単にロケール名（日付や数値の書式指定を指し、必ずしも UI 言語を指すとは限らない）ではなく、QLocale::uiLanguages() を使用するためです。

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

filename +prefix +ui language name +suffix （suffix が指定されていない場合は「.qm」）を読み込みます。これらは絶対ファイル名でも、directory からの相対パスでも構いません。翻訳の読み込みに成功した場合はtrue を返し、失敗した場合はfalse を返します。

この翻訳オブジェクトの以前の内容は破棄されます。

ファイル名が存在しない場合、以下の順序で他のファイル名が試されます：

1. 「suffix 」が末尾に付加されていないファイル名。
2. 「_」文字の後に続く UI 言語部分を削除したファイル名に、suffix を付加したもの。
3. UI言語部分が削除され、suffix が追加されていないファイル名。
4. UI言語部分をさらに削除したファイル名、など。

たとえば、以下のui languages （「es」、「fr-CA」、「de」）を持つlocale で実行されているアプリケーションは、load(QLocale(), "foo", ".", "/opt/foolib", ".qm") を呼び出す可能性があります。 load() は、UI 言語の '-' (ダッシュ) を '_' (アンダースコア) に置き換え、その後、以下のリストから最初に存在する読み取り可能なファイルを開こうとします:

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

ファイルシステムが大文字と小文字を区別するオペレーティングシステムでは、QTranslator はロケール名の大文字を小文字に変換したバージョンも読み込もうとします。

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

長さlen のQMファイルデータ「data 」をトランスレータに読み込みます。

データはコピーされません。呼び出し元は、data が削除または変更されないことを保証できる必要があります。

directory は、QM ファイルの依存関係を読み込む際のベースディレクトリを指定するためにのみ使用されます。ファイルに依存関係がない場合、この引数は無視されます。

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

キー (context 、sourceText 、disambiguation) に対応する翻訳を返します。該当する翻訳が見つからない場合は、(context 、sourceText 、"") についても検索を試みます。それでも見つからない場合は、空文字列を返します。

n が -1 以外の場合、その値は翻訳の適切な形式（例: "%n ファイルが見つかりました" 対 "%n ファイルが見つかりました"）を選択するために使用されます。

QTranslator に翻訳をプログラムで挿入する必要がある場合は、この関数を再実装することができます。

注: この関数はスレッドセーフです。

load()も参照してください 。