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(const QLocale &, const QString &, const QString &, const QString &, const QString &) 함수를 사용하는 것이 더 좋습니다. 이 함수는 단순히 로케일 이름만 사용하는 것이 아니라 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. suffix 가 추가되지 않은 상태에서 UI 언어 부분이 제거된 파일 이름.
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()도 참조하십시오 .