QFontDatabase Class

QTreeWidget fontTree;
fontTree.setColumnCount(2);
fontTree.setHeaderLabels(QStringList() << "Font" << "Smooth Sizes");

const QStringList fontFamilies = QFontDatabase::families();
for (const QString &family : fontFamilies) {
    QTreeWidgetItem *familyItem = new QTreeWidgetItem(&fontTree);
    familyItem->setText(0, family);

    const QStringList fontStyles = QFontDatabase::styles(family);
    for (const QString &style : fontStyles) {
        QTreeWidgetItem *styleItem = new QTreeWidgetItem(familyItem);
        styleItem->setText(0, style);

        QString sizes;
        const QList<int> smoothSizes = QFontDatabase::smoothSizes(family, style);
        for (const auto &points : smoothSizes)
            sizes += QString::number(points) + ' ';

        styleItem->setText(1, sizes.trimmed());
    }
}

멤버 함수 문서

[static, since 6.9] void QFontDatabase::addApplicationEmojiFontFamily(const QString &familyName)

familyName 를 애플리케이션 정의 이모지 글꼴로 추가합니다.

다색 이모지나 이모지 시퀀스를 표시할 때, Qt는 기본적으로 시스템의 기본 이모지 글꼴을 우선적으로 사용합니다. 때로는 특정 시각적 스타일을 구현하거나 시스템에서 지원하지 않는 이모지를 표시하기 위해 애플리케이션에서 기본 설정을 재정의해야 할 수도 있습니다.

이 함수는 Qt 6.9에서 도입되었습니다.

removeApplicationEmojiFontFamily, setApplicationEmojiFontFamilies(), applicationEmojiFontFamilies() 및 addApplicationFallbackFontFamily()도 참조하십시오 .

[static, since 6.8] void QFontDatabase::addApplicationFallbackFontFamily(QChar::Script script, const QString &familyName)

script 에 대해 ‘ familyName ’을 애플리케이션 정의 대체 글꼴로 추가합니다.

Qt는 선택된 글꼴에서 지원되지 않는 문자를 만나면 대체 글꼴 목록을 검색하여 해당 문자와 일치하는 글꼴을 찾습니다. 이를 통해 주 글꼴이 지원하지 않는 경우에도 단일 문자열 내에서 여러 문자 체계를 조합할 수 있습니다.

대체 글꼴 목록은 문자열의 문자 체계와 시스템 언어와 같은 기타 조건을 바탕으로 선택됩니다.

일반적으로 시스템의 대체 글꼴 목록만으로도 충분하지만, 기본 동작을 재정의하는 것이 유용한 경우도 있습니다. 그 중 하나는 크로스 플랫폼 일관성을 보장하기 위해 애플리케이션 글꼴을 대체 글꼴로 사용하는 경우입니다.

또 다른 경우로, 애플리케이션이 지역별 차이가 있는 스크립트로 작성되었으며 여러 지역에서 번역 없이 실행하고자 할 수 있습니다. 이 경우, 해당 지역의 대체 목록을 애플리케이션 언어에 맞는 것으로 재정의하는 것이 유용할 수 있습니다.

familyName 를 addApplicationFallbackFontFamily()에 전달하면, script 에서 누락된 문자를 매칭할 때 이 글꼴 패밀리가 우선적으로 사용됩니다. script 는 유효한 문자 체계(QChar::Script_Latin 이상)여야 합니다. 동일한 문자 체계에 대해 여러 글꼴을 추가할 경우, 우선순위는 역순으로 적용되므로 마지막으로 추가된 패밀리가 먼저 확인되는 식으로 처리됩니다.

이 함수는 Qt 6.8에서 도입되었습니다.

setApplicationFallbackFontFamilies(), removeApplicationFallbackFontFamily(), applicationFallbackFontFamilies()도 참조하십시오 .

[static] int QFontDatabase::addApplicationFont(const QString &fileName)

fileName 로 지정된 파일에서 글꼴을 불러와 응용 프로그램에서 사용할 수 있도록 합니다. 반환된 ID를 사용하여 removeApplicationFont() 함수를 통해 글꼴을 다시 제거하거나, 해당 글꼴에 포함된 글꼴군 이름 목록을 가져올 수 있습니다.

글꼴을 불러올 수 없는 경우 이 함수는 -1을 반환합니다.

현재는 트루타입(TrueType) 글꼴, 트루타입 글꼴 모음 및 오픈타입(OpenType) 글꼴만 지원됩니다.

addApplicationFontFromData(), applicationFontFamilies() 및 removeApplicationFont()도 참조하십시오 .

[static] int QFontDatabase::addApplicationFontFromData(const QByteArray &fontData)

fontData 로 지정된 바이너리 데이터에서 글꼴을 불러와 애플리케이션에서 사용할 수 있도록 합니다. 반환된 ID는 removeApplicationFont()를 통해 글꼴을 다시 제거하거나, 글꼴에 포함된 글꼴군 이름 목록을 가져오는 데 사용할 수 있습니다.

글꼴을 불러올 수 없는 경우 이 함수는 -1을 반환합니다.

현재는 트루타입(TrueType) 글꼴, 트루타입 글꼴 모음 및 오픈타입(OpenType) 글꼴만 지원됩니다.

addApplicationFont(), applicationFontFamilies() 및 removeApplicationFont()도 참조하십시오 .

[static, since 6.9] QStringList QFontDatabase::applicationEmojiFontFamilies()

애플리케이션에서 정의한 이모지 글꼴 패밀리 목록을 반환합니다.

이 함수는 Qt 6.9에서 도입되었습니다.

addApplicationEmojiFontFamily(), removeApplicationEmojiFontFamily(), setApplicationEmojiFontFamilies(), applicationFallbackFontFamilies()도 참조하십시오 .

[static, since 6.8] QStringList QFontDatabase::applicationFallbackFontFamilies(QChar::Script script)

addApplicationFallbackFontFamily() 함수를 통해 이전에 ` script `에 추가된, 애플리케이션에서 정의한 대체 글꼴 패밀리 목록을 반환합니다.

이 함수는 Qt 6.8에서 도입되었습니다.

setApplicationFallbackFontFamilies(), addApplicationFallbackFontFamily() 및 removeApplicationFallbackFontFamily()도 참조하십시오 .

[static] QStringList QFontDatabase::applicationFontFamilies(int id)

id 로 식별되는 지정된 애플리케이션 글꼴에 대한 글꼴 패밀리 목록을 반환합니다.

addApplicationFont() 및 addApplicationFontFromData()도 참조하십시오 .

[static] bool QFontDatabase::bold(const QString &family, const QString &style)

가족이 family 이고 스타일이 style 인 글꼴이 굵은체(bold)인 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

italic() 및 weight()도 참조하십시오 .

[static] QStringList QFontDatabase::families(QFontDatabase::WritingSystem writingSystem = Any)

writingSystem 를 지원하는 사용 가능한 글꼴 패밀리의 정렬된 목록을 반환합니다.

한 글꼴 패밀리가 여러 폰트 제작사에서 제공되는 경우, 해당 글꼴의 반환된 이름은 "패밀리 [제작사]" 형식을 따릅니다. 예: "Times [Adobe]", "Times [Cronyx]", "Palatino".

writingSystems()도 참조하십시오 .

[static] QFont QFontDatabase::font(const QString &family, const QString &style, int pointSize)

family 의 서체 계열, style 의 스타일, pointSize 의 포인트 크기를 가진 QFont 객체를 반환합니다. 일치하는 글꼴을 생성할 수 없는 경우, 애플리케이션의 기본 글꼴을 사용하는 QFont 객체가 반환됩니다.

[static] bool QFontDatabase::isBitmapScalable(const QString &family, const QString &style = QString())

글꼴 패밀리가 family 이고 스타일이 style 인 글꼴이 확장 가능한 비트맵 글꼴인 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다. 비트맵 글꼴을 확대·축소하면 글꼴의 픽셀이 함께 확대·축소되기 때문에 대개 보기 흉하고 읽기 힘든 결과가 나옵니다. 비트맵 글꼴을 확대·축소해야 하는 경우, smoothSizes() 함수가 반환하는 고정 크기 중 하나로 조정하는 것이 좋습니다.

isScalable() 및 isSmoothlyScalable()도 참조하십시오 .

[static] bool QFontDatabase::isFixedPitch(const QString &family, const QString &style = QString())

가족(family)이 family 이고 스타일(style)이 style 인 글꼴이 고정폭 글꼴인 경우 ` true `을 반환하고, 그렇지 않은 경우 ` false`을 반환합니다.

[static] bool QFontDatabase::isPrivateFamily(const QString &family)

family 글꼴 패밀리가 비공개일 때만 true 를 반환합니다.

예를 들어, macOS 및 iOS에서는 시스템 UI 글꼴에 사용자가 접근할 수 없기 때문에 이러한 현상이 발생합니다. 참고로, ` QFontDatabase::families()`는 비공개 글꼴을 포함하여 모든 글꼴 패밀리를 반환합니다. 글꼴 선택 컨트롤을 개발할 때 비공개 글꼴을 숨기려면 이 함수를 사용해야 합니다.

families()도 참조하십시오 .

[static] bool QFontDatabase::isScalable(const QString &family, const QString &style = QString())

가족이 family 이고 스타일이 style 인 글꼴이 확장 가능한 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.

isBitmapScalable() 및 isSmoothlyScalable()도 참조하십시오 .

[static] bool QFontDatabase::isSmoothlyScalable(const QString &family, const QString &style = QString())

글꼴 패밀리 family 과 스타일 style 을 가진 글꼴이 부드럽게 크기 조절이 가능한 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다. 이 함수가 true 을 반환하면, 해당 글꼴을 어떤 크기로든 안전하게 크기 조절할 수 있으며, 결과물은 항상 보기 좋게 표시됩니다.

isScalable() 및 isBitmapScalable()도 참조하십시오 .

[static] bool QFontDatabase::italic(const QString &family, const QString &style)

가족이 family 이고 스타일이 style 인 글꼴이 이탤릭체인 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

weight() 및 bold()도 참조하십시오 .

[static] QList<int> QFontDatabase::pointSizes(const QString &family, const QString &styleName = QString())

family 패밀리와 styleName 스타일을 가진 글꼴에서 사용할 수 있는 포인트 크기 목록을 반환합니다. 이 목록은 비어 있을 수도 있습니다.

smoothSizes() 및 standardSizes()도 참조하십시오 .

[static] bool QFontDatabase::removeAllApplicationFonts()

addApplicationFont() 및 addApplicationFontFromData()를 사용하여 이전에 추가된 모든 애플리케이션 로컬 글꼴을 제거합니다.

글꼴 제거에 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

removeApplicationFont(), addApplicationFont() 및 addApplicationFontFromData()도 참조하십시오 .

[static, since 6.9] bool QFontDatabase::removeApplicationEmojiFontFamily(const QString &familyName)

이전에 addApplicationEmojiFontFamily()를 통해 추가된 경우, 애플리케이션에서 정의한 이모지 글꼴 목록에서 familyName 를 제거합니다.

가족 이름이 목록에 포함되어 있으면 true를, 포함되어 있지 않으면 false를 반환합니다.

이 함수는 Qt 6.9에서 도입되었습니다.

addApplicationEmojiFontFamily(), setApplicationEmojiFontFamilies(), applicationEmojiFontFamilies() 및 removeApplicationFallbackFontFamily()도 참조하십시오 .

[static, since 6.8] bool QFontDatabase::removeApplicationFallbackFontFamily(QChar::Script script, const QString &familyName)

이전 addApplicationFallbackFontFamily() 함수를 통해 추가된 경우, script 에 대한 애플리케이션 정의 대체 글꼴 목록에서 familyName 을 제거합니다.

글꼴 패밀리 이름이 목록에 포함되어 있으면 true를, 포함되어 있지 않으면 false를 반환합니다.

이 함수는 Qt 6.8에서 도입되었습니다.

addApplicationFallbackFontFamily(), setApplicationFallbackFontFamilies() 및 applicationFallbackFontFamilies()도 참조하십시오 .

[static] bool QFontDatabase::removeApplicationFont(int id)

id 로 식별되는 이전에 로드된 애플리케이션 글꼴을 제거합니다. 글꼴 제거에 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

removeAllApplicationFonts(), addApplicationFont(), addApplicationFontFromData()도 참조하십시오 .

[static, since 6.9] void QFontDatabase::setApplicationEmojiFontFamilies(const QStringList &familyNames)

애플리케이션에서 정의한 이모지 글꼴 목록을 ` familyNames`로 설정합니다.

이 함수는 Qt 6.9에서 도입되었습니다.

addApplicationEmojiFontFamily(), removeApplicationEmojiFontFamily(), applicationEmojiFontFamilies() 및 setApplicationFallbackFontFamilies()도 참조하십시오 .

[static, since 6.8] void QFontDatabase::setApplicationFallbackFontFamilies(QChar::Script script, const QStringList &familyNames)

script 에 대한 애플리케이션 정의 대체 글꼴 목록을 familyNames 로 설정합니다.

Qt가 ` script `에서 현재 글꼴이 지원하지 않는 문자를 발견하면, 일치하는 글꼴을 찾을 때까지 ` familyNames`에 있는 글꼴 패밀리를 첫 번째부터 마지막 순서대로 확인합니다. 자세한 내용은 ` addApplicationFallbackFontFamily()`를 참조하십시오.

이 함수는 script 에 대한 애플리케이션 정의 대체 글꼴의 현재 목록을 덮어씁니다.

이 함수는 Qt 6.8에서 도입되었습니다.

addApplicationFallbackFontFamily(), removeApplicationFallbackFontFamily() 및 applicationFallbackFontFamilies()도 참조하십시오 .

[static] QList<int> QFontDatabase::smoothSizes(const QString &family, const QString &styleName)

family 폰트 패밀리와 styleName 스타일을 가진 폰트 중에서 시각적으로 보기 좋은 포인트 크기를 반환합니다. 이 목록은 비어 있을 수도 있습니다. 비확장형 폰트 및 비트맵 확장형 폰트의 경우, 이 함수는 pointSizes() 함수와 동일합니다.

pointSizes() 및 standardSizes()도 참조하십시오 .

[static] QList<int> QFontDatabase::standardSizes()

표준 글꼴 크기 목록을 반환합니다.

smoothSizes() 및 pointSizes()도 참조하십시오 .

[static] QString QFontDatabase::styleString(const QFont &font)

font 의 서식을 설명하는 문자열을 반환합니다. 예를 들어, "굵은 이탤릭체", "굵은체", "이탤릭체" 또는 "일반" 등이 있습니다. 빈 문자열이 반환될 수도 있습니다.

[static] QString QFontDatabase::styleString(const QFontInfo &fontInfo)

fontInfo 의 서식을 설명하는 문자열을 반환합니다. 예를 들어, "굵은 이탤릭체", "굵은체", "이탤릭체" 또는 "일반" 등이 있습니다. 빈 문자열이 반환될 수도 있습니다.

[static] QStringList QFontDatabase::styles(const QString &family)

family 글꼴 패밀리에 사용할 수 있는 스타일 목록을 반환합니다. 스타일의 예시로는 "Light", "Light Italic", "Bold", "Oblique", "Demi" 등이 있습니다. 이 목록은 비어 있을 수도 있습니다.

families()도 참조하십시오 .

[static] QFont QFontDatabase::systemFont(QFontDatabase::SystemFont type)

type 의 특정 대소문자 구분에 가장 적합한 글꼴을 반환하여, 시스템의 디자인 및 사용감과 자연스럽게 조화를 이룰 수 있도록 합니다.

QGuiApplication::font()도 참조하십시오 .

[static] int QFontDatabase::weight(const QString &family, const QString &style)

family 라는 글꼴 패밀리와 style 라는 스타일을 가진 글꼴의 굵기를 반환합니다. 해당 패밀리와 스타일의 조합이 없는 경우 -1을 반환합니다.

italic() 및 bold()도 참조하십시오 .

[static] QString QFontDatabase::writingSystemName(QFontDatabase::WritingSystem writingSystem)

writingSystem 의 이름을 반환합니다(예: 대화 상자에서 사용자에게 표시하기 위해).

[static] QString QFontDatabase::writingSystemSample(QFontDatabase::WritingSystem writingSystem)

writingSystem 에서 가져온 샘플 문자가 포함된 문자열을 반환합니다.

[static] QList<QFontDatabase::WritingSystem> QFontDatabase::writingSystems()

사용 가능한 문자 체계의 정렬된 목록을 반환합니다. 이 목록은 시스템에 설치된 모든 글꼴에 대한 정보를 바탕으로 생성됩니다.

families()도 참조하십시오 .

[static] QList<QFontDatabase::WritingSystem> QFontDatabase::writingSystems(const QString &family)

주어진 글꼴 family 이 지원하는 문자 체계를 정렬된 목록으로 반환합니다.

families()도 참조하십시오 .