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 (".qm"( suffix 이 지정되지 않은 경우)(절대 파일 이름 또는 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

일반적으로, 단순히 로캘 이름이 아닌 QLocale::uiLanguages()를 사용하고 날짜와 숫자의 서식을 참조하며 반드시 UI 언어가 아니기 때문에 QTranslator::load(const QLocale &, const QString &, const QString &, const QString &, const QString &) 함수를 대신 사용하는 것이 더 좋습니다.

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 (".qm"( suffix 이 지정되지 않은 경우)을 로드합니다(절대 파일 이름일 수도 있고 directory 에 상대적일 수도 있음). 번역이 성공적으로 로드되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

이 번역기 객체의 이전 내용은 삭제됩니다.

파일 이름이 존재하지 않으면 다음 순서로 다른 파일 이름을 시도합니다:

1. suffix 가 추가되지 않은 파일 이름.
2. "_" 문자가 제거된 파일 이름과 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())

이 함수는 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 파일 발견" 대 "%n 파일 발견").

프로그래밍 방식으로 번역을 QTranslator 에 삽입해야 하는 경우 이 함수를 다시 구현할 수 있습니다.

load()도 참조하세요 .