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

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

[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() のように）。

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

ファイル名が存在しない場合、他のファイル名が次の順序で試される：

1. suffix が付加されていないファイル名。
2. search_delimiters の文字以降のテキストを取り除いたファイル名（search_delimiters が空文字列の場合、"_." がデフォルト）、およびsuffix 。
3. suffix が付加されずに取り除かれたファイル名。
4. ファイル名をさらに取り除いたものなど。

例えば、fr_CAロケール（フランス語圏のカナダ）で動作するアプリケーションは、load("foo.fr_ca", "/opt/foolib")を呼び出すかもしれない：

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 &)関数を使用する方が良いでしょう。これは、単にロケール名ではなく、QLocale::uiLanguages()を使用するからです。 ()は、日付や数値の書式を参照しており、必ずしもUI言語を参照しているわけではありません。

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言語部分がさらに取り除かれたファイル名など。

たとえば、locale で実行されているアプリケーションで、ui languages - "es", "fr-CA", "de" を使用している場合、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())

この関数は load() をオーバーロードします。

長さ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, "") も試します。それでも見つからない場合は、NULL文字列を返します。

(n, , "") の翻訳が提供されていない場合、このメソッドは実際には異なる の翻訳を返すかもしれません。 が -1 でない場合、翻訳の適切な形式を選択するために使用されます (例えば、"%n file found" vs. "%n files found")。

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

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