QFont Class

QFont 클래스는 텍스트 그리기에 사용되는 글꼴에 대한 쿼리를 지정합니다. 더 보기...

Header: #include <QFont>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

참고: 이 클래스의 모든 함수는 재진입됩니다.

공용 유형

(since 6.7) struct Tag
enum Capitalization { MixedCase, AllUppercase, AllLowercase, SmallCaps, Capitalize }
enum HintingPreference { PreferDefaultHinting, PreferNoHinting, PreferVerticalHinting, PreferFullHinting }
enum SpacingType { PercentageSpacing, AbsoluteSpacing }
enum Stretch { AnyStretch, UltraCondensed, ExtraCondensed, Condensed, SemiCondensed, …, UltraExpanded }
enum Style { StyleNormal, StyleItalic, StyleOblique }
enum StyleHint { AnyStyle, SansSerif, Helvetica, Serif, Times, …, System }
enum StyleStrategy { PreferDefault, PreferBitmap, PreferDevice, PreferOutline, ForceOutline, …, PreferQuality }
enum Weight { Thin, ExtraLight, Light, Normal, Medium, …, Black }

공용 함수

QFont()
QFont(const QFont &font, const QPaintDevice *pd)
QFont(const QString &family, int pointSize = -1, int weight = -1, bool italic = false)
QFont(const QStringList &families, int pointSize = -1, int weight = -1, bool italic = false)
QFont(const QFont &font)
~QFont()
bool bold() const
QFont::Capitalization capitalization() const
(since 6.7) void clearFeatures()
(since 6.7) void clearVariableAxes()
QString defaultFamily() const
bool exactMatch() const
QStringList families() const
QString family() const
(since 6.7) QList<QFont::Tag> featureTags() const
(since 6.7) quint32 featureValue(QFont::Tag tag) const
bool fixedPitch() const
bool fromString(const QString &descrip)
QFont::HintingPreference hintingPreference() const
bool isCopyOf(const QFont &f) const
(since 6.7) bool isFeatureSet(QFont::Tag tag) const
(since 6.7) bool isVariableAxisSet(QFont::Tag tag) const
bool italic() const
bool kerning() const
QString key() const
qreal letterSpacing() const
QFont::SpacingType letterSpacingType() const
bool overline() const
int pixelSize() const
int pointSize() const
qreal pointSizeF() const
QFont resolve(const QFont &other) const
void setBold(bool enable)
void setCapitalization(QFont::Capitalization caps)
void setFamilies(const QStringList &families)
void setFamily(const QString &family)
(since 6.7) void setFeature(QFont::Tag tag, quint32 value)
void setFixedPitch(bool enable)
void setHintingPreference(QFont::HintingPreference hintingPreference)
void setItalic(bool enable)
void setKerning(bool enable)
void setLetterSpacing(QFont::SpacingType type, qreal spacing)
void setOverline(bool enable)
void setPixelSize(int pixelSize)
void setPointSize(int pointSize)
void setPointSizeF(qreal pointSize)
void setStretch(int factor)
void setStrikeOut(bool enable)
void setStyle(QFont::Style style)
void setStyleHint(QFont::StyleHint hint, QFont::StyleStrategy strategy = PreferDefault)
void setStyleName(const QString &styleName)
void setStyleStrategy(QFont::StyleStrategy s)
void setUnderline(bool enable)
(since 6.7) void setVariableAxis(QFont::Tag tag, float value)
void setWeight(QFont::Weight weight)
void setWordSpacing(qreal spacing)
int stretch() const
bool strikeOut() const
QFont::Style style() const
QFont::StyleHint styleHint() const
QString styleName() const
QFont::StyleStrategy styleStrategy() const
void swap(QFont &other)
QString toString() const
bool underline() const
(since 6.7) void unsetFeature(QFont::Tag tag)
(since 6.7) void unsetVariableAxis(QFont::Tag tag)
(since 6.7) QList<QFont::Tag> variableAxisTags() const
(since 6.7) float variableAxisValue(QFont::Tag tag) const
QFont::Weight weight() const
qreal wordSpacing() const
QVariant operator QVariant() const
bool operator!=(const QFont &f) const
bool operator<(const QFont &f) const
QFont &operator=(QFont &&other)
QFont &operator=(const QFont &font)
bool operator==(const QFont &f) const

정적 공용 멤버

void insertSubstitution(const QString &familyName, const QString &substituteName)
void insertSubstitutions(const QString &familyName, const QStringList &substituteNames)
void removeSubstitutions(const QString &familyName)
QString substitute(const QString &familyName)
QStringList substitutes(const QString &familyName)
QStringList substitutions()
size_t qHash(const QFont &key, size_t seed = 0)
QDataStream &operator<<(QDataStream &s, const QFont &font)
QDataStream &operator>>(QDataStream &s, QFont &font)

상세 설명

QFont는 시스템에서 하나 이상의 글꼴에 대한 쿼리로 간주할 수 있습니다.

QFont 객체를 만들 때 글꼴이 갖기를 원하는 다양한 속성을 지정합니다. Qt는 지정된 속성을 가진 글꼴을 사용하거나, 일치하는 글꼴이 없는 경우 가장 가까운 일치하는 설치된 글꼴을 사용합니다. 실제로 사용되는 글꼴의 속성은 QFontInfo 객체에서 검색할 수 있습니다. 창 시스템이 정확히 일치하는 exactMatch()를 제공하는 경우 true 을 반환합니다. QFontMetricsF 를 사용하여 측정값(예: QFontMetrics::width()를 사용하여 문자열의 픽셀 길이)을 가져옵니다.

특별히 설정되지 않은 속성은 글꼴 선택 알고리즘에 영향을 미치지 않으며 대신 기본값이 선호됩니다.

일반적으로 단일 파일로 표시되는 특정 실제 글꼴을 로드하려면 QRawFont 을 대신 사용합니다.

QFont를 사용하려면 QGuiApplication 인스턴스가 존재해야 합니다. QGuiApplication::setFont ()로 애플리케이션의 기본 글꼴을 설정할 수 있습니다.

선택한 글꼴에 표시해야 하는 모든 문자가 포함되어 있지 않은 경우 QFont는 가장 가까운 동등한 글꼴에서 문자를 찾으려고 시도합니다. QPainter 글꼴에서 문자를 그릴 때 QFont는 해당 문자가 있는지 여부를 보고하고, 없는 경우 QPainter 채워지지 않은 사각형을 그립니다.

이렇게 QFont를 생성합니다:

QFont serifFont("Times", 10, QFont::Bold);
QFont sansFont("Helvetica [Cronyx]", 12);

생성자에서 설정된 속성(예: setFamily(), setPointSize(), setPointSizeF(), setWeight() 및 setItalic())은 나중에 설정할 수도 있습니다. setBold (), setUnderline(), setOverline(), setStrikeOut(), setFixedPitch() 등 나머지 속성은 생성 후에 설정해야 합니다. QFontInfo 객체는 글꼴의 속성이 설정된 후에 생성해야 합니다. 글꼴의 속성을 변경하더라도 QFontInfo 객체는 변경되지 않습니다. family (), pointSize() 등과 같은 해당 "get" 함수는 사용된 값이 다를 수 있지만 설정된 값을 반환합니다. 실제 값은 QFontInfo 객체에서 사용할 수 있습니다.

요청한 글꼴 패밀리를 사용할 수 없는 경우 setStyleHint()를 사용하여 특정 QFont::StyleHintQFont::StyleStrategy 을 선택하여 font matching algorithm 에 영향을 줄 수 있습니다. 기본 패밀리(현재 스타일 힌트에 해당)는 defaultFamily()로 반환됩니다.

insertSubstitution() 및 insertSubstitutions()를 사용하여 글꼴 패밀리 이름에 대한 대체를 제공할 수 있습니다. removeSubstitutions ()로 대체를 제거할 수 있습니다. substitute ()를 사용하여 계열의 첫 번째 대체어를 검색하거나 대체어가 없는 경우 계열 이름 자체를 검색합니다. substitutes ()를 사용하여 가족의 대체 목록(비어 있을 수 있음)을 검색합니다. 글꼴을 대체한 후에는 모든 QFont 개체를 삭제하고 다시 생성하여 글꼴 업데이트를 트리거해야 합니다.

모든 QFont에는 예를 들어 캐시나 사전의 키로 사용할 수 있는 key()가 있습니다. 사용자의 글꼴 기본 설정을 저장하려면 QSettings, toString()로 글꼴 정보를 쓰고 fromString()로 다시 읽을 수 있습니다. 연산자<<() 및 연산자>>() 함수도 사용할 수 있지만 데이터 스트림에서 작동합니다.

setPixelSize()를 사용하여 화면에 표시되는 문자의 높이를 지정된 픽셀 수로 설정할 수 있지만 setPointSize()를 사용하는 것도 비슷한 효과를 내며 디바이스 독립성을 제공합니다.

글꼴 로딩은 특히 X11에서 비용이 많이 들 수 있습니다. QFont에는 QFont 개체를 빠르게 복사하고 느린 창 시스템 기능의 결과를 캐시하기 위한 광범위한 최적화가 포함되어 있습니다.

글꼴 일치 알고리즘은 다음과 같이 작동합니다:

  1. 지정된 글꼴 패밀리( setFamilies()로 설정)를 검색합니다.
  2. 그렇지 않은 경우 쓰기 시스템을 지원하는 대체 글꼴이 선택됩니다. 글꼴 일치 알고리즘은 QFont에 설정된 모든 속성에 가장 잘 맞는 글꼴을 찾으려고 노력합니다. 이 작업이 수행되는 방식은 플랫폼마다 다릅니다.
  3. 시스템에 텍스트를 지원할 수 있는 글꼴이 없는 경우 그 자리에 특수한 '누락된 문자' 상자가 표시됩니다.

참고: 선택한 글꼴이 일반적으로 쓰기 시스템을 지원하지만 하나 이상의 특정 문자에 대한 글리프가 누락된 경우, Qt는 이 문자 또는 이러한 특정 문자에 대한 대체 글꼴을 찾으려고 시도합니다. 이 기능은 QFont::NoFontMerging 스타일 전략을 사용하여 비활성화할 수 있습니다.

Windows에서 "Courier" 글꼴에 대한 요청은 부드러운 크기 조정이 가능한 Courier의 개선된 버전인 "Courier New"로 자동 변경됩니다. PreferBitmap 스타일 전략( setStyleStrategy() 참조)을 설정하여 이전 "Courier" 비트맵 글꼴을 선택할 수 있습니다.

글꼴을 찾으면 나머지 속성은 우선순위에 따라 일치합니다:

  1. fixedPitch()
  2. pointSize() (아래 참조)
  3. weight()
  4. style()

패밀리에서 일치하는 글꼴이 있는 경우 다른 속성이 일치하지 않더라도 패밀리에서는 일치하지 않지만 다른 속성에서는 일치하는 글꼴보다 이 글꼴이 우선적으로 선택됩니다. 이는 글꼴 패밀리가 주요 검색 기준이기 때문입니다.

포인트 크기는 요청된 포인트 크기의 20% 이내인 경우 일치하도록 정의됩니다. 여러 글꼴이 일치하고 포인트 크기로만 구분되는 경우 요청된 글꼴에 가장 가까운 포인트 크기를 가진 글꼴이 선택됩니다.

텍스트를 그리는 데 사용되는 실제 글꼴 패밀리, 글꼴 크기, 굵기 및 기타 글꼴 속성은 창 시스템에서 선택한 패밀리에서 사용할 수 있는 것에 따라 달라집니다. QFontInfo 객체를 사용하여 텍스트를 그리는 데 사용되는 실제 값을 확인할 수 있습니다.

예시

QFont f("Helvetica");

Adobe와 Cronyx Helvetica가 모두 있는 경우 둘 중 하나를 가져올 수 있습니다.

QFont f("Helvetica [Cronyx]");

패밀리 이름에 원하는 파운드리를 지정할 수 있습니다. 위 예제에서 글꼴 f는 "Helvetica [Cronyx]"로 설정됩니다.

창 시스템에서 실제로 사용되는 글꼴의 속성을 확인하려면 QFontInfo 객체를 사용합니다(예

QFontInfo info(f1);
QString family = info.family();

글꼴 메트릭을 확인하려면 QFontMetrics 객체를 사용합니다.

QFontMetrics fm(f1);
int textWidthInPixels = fm.horizontalAdvance("How many pixels wide is this text?");
int textHeightInPixels = fm.height();

글꼴에 대한 일반적인 정보는 comp.fonts FAQ를 참조하세요. 인코딩에 대한 정보는 UTR17 페이지에서 찾을 수 있습니다.

QFontMetrics, QFontInfo, QFontDatabase참조하세요 .

멤버 유형 문서

enum QFont::Capitalization

이 글꼴이 적용되는 텍스트의 렌더링 옵션입니다.

Constant설명
QFont::MixedCase0대문자 변경이 적용되지 않는 일반 텍스트 렌더링 옵션입니다.
QFont::AllUppercase1텍스트가 모든 대문자로 렌더링되도록 변경됩니다.
QFont::AllLowercase2텍스트가 모든 소문자로 렌더링되도록 변경합니다.
QFont::SmallCaps3텍스트가 소문자 유형으로 렌더링되도록 변경됩니다.
QFont::Capitalize4각 단어의 첫 번째 문자가 대문자로 렌더링되도록 텍스트가 변경됩니다.

enum QFont::HintingPreference

이 열거형은 픽셀 밀도에 따라 디스플레이에서 가독성을 향상시키기 위해 글리프에 적용할 수 있는 다양한 수준의 힌트를 설명합니다.

Constant설명
QFont::PreferDefaultHinting0대상 플랫폼의 기본 힌트 수준을 사용합니다.
QFont::PreferNoHinting1가능하면 글리프의 윤곽선을 힌트하지 않고 텍스트를 렌더링합니다. 텍스트 레이아웃은 인쇄할 때 사용되는 것과 동일한 메트릭을 사용하여 타이포그래피적으로 정확하고 확장 가능합니다.
QFont::PreferVerticalHinting2가능하면 가로 힌트 없이 텍스트를 렌더링하되 글리프를 세로 방향의 픽셀 그리드에 정렬하세요. 밀도가 너무 낮아 글리프를 정확하게 렌더링할 수 없는 디스플레이에서는 텍스트가 더 선명하게 표시됩니다. 그러나 글리프의 가로 메트릭은 암시되지 않으므로 텍스트의 레이아웃은 줄 바꿈과 같은 세부 사항에 영향을 주지 않고 고밀도 장치(예: 프린터)로 확장할 수 있습니다.
QFont::PreferFullHinting3가능하면 가로 및 세로 방향 모두에 힌트가 있는 텍스트를 렌더링하세요. 대상 디바이스에서 가독성을 최적화하기 위해 텍스트가 변경되지만 메트릭은 텍스트의 대상 크기에 따라 달라지므로 글리프, 줄 바꿈 및 기타 타이포그래피 디테일의 위치는 크기가 조정되지 않으므로 픽셀 밀도가 다른 디바이스에서 텍스트 레이아웃이 다르게 보일 수 있습니다.

이 열거형은 기본 설정만 설명하므로 Qt가 지원하는 모든 플랫폼에서 전체 힌트 레벨이 지원되지는 않습니다. 다음 표는 지정된 힌팅 환경 설정이 선택한 대상 플랫폼 세트에 미치는 영향을 자세히 설명합니다.

PreferDefaultHintingPreferNoHintingPreferVerticalHintingPreferFullHinting
Qt에서 Windows 및 DirectWrite 활성화전체 힌트수직 힌트세로 힌트전체 힌트
자유형운영 체제 설정힌트 없음세로 힌트(밝게)전체 힌트
macOS의 코코아힌트 없음힌트 없음힌트 없음힌트 없음

enum QFont::SpacingType

상수설명
QFont::PercentageSpacing0100 값은 간격을 변경하지 않고 유지하며, 200 값은 문자 자체 너비만큼 문자 뒤의 간격을 확대합니다.
QFont::AbsoluteSpacing1양수 값은 해당 픽셀만큼 문자 간격을 늘리고 음수 값은 간격을 줄입니다.

enum QFont::Stretch

CSS 명명 규칙을 따르는 미리 정의된 늘이기 값입니다. 값이 클수록 텍스트가 더 늘어납니다.

상수설명
QFont::AnyStretch (since Qt 5.8)00 다른 QFont 속성을 사용하여 일치하는 모든 스트레치 허용
QFont::UltraCondensed5050
QFont::ExtraCondensed6262
QFont::Condensed7575
QFont::SemiCondensed8787
QFont::Unstretched100100
QFont::SemiExpanded112112
QFont::Expanded125125
QFont::ExtraExpanded150150
QFont::UltraExpanded200200

setStretch() 및 stretch()도 참조하세요 .

enum QFont::Style

이 열거형은 텍스트를 표시하는 데 사용되는 다양한 글리프 스타일을 설명합니다.

Constant설명
QFont::StyleNormal0스타일이 지정되지 않은 텍스트에 사용되는 일반 글리프입니다.
QFont::StyleItalic1이탤릭체 텍스트를 표현하기 위해 특별히 디자인된 이탤릭체 글리프.
QFont::StyleOblique2일반적으로 스타일이 지정되지 않은 글리프를 기반으로 하지만 이탤릭체 텍스트를 표현하기 위해 미세 조정되지 않은 이탤릭체 모양을 가진 글리프입니다.

Weight참조하세요 .

enum QFont::StyleHint

스타일 힌트는 font matching 알고리즘에서 선택한 글꼴 패밀리를 사용할 수 없는 경우 적절한 기본 글꼴 패밀리를 찾는 데 사용됩니다.

상수설명
QFont::AnyStyle5글꼴 일치 알고리즘에 글꼴 패밀리를 선택하도록 맡깁니다. 이것이 기본값입니다.
QFont::SansSerifHelvetica글꼴 일치기는 산세리프 글꼴을 선호합니다.
QFont::Helvetica0SansSerif 와 동의어입니다.
QFont::SerifTimes글꼴 일치기가 세리프 글꼴을 선호합니다.
QFont::Times1Serif 와 동의어입니다.
QFont::TypeWriterCourier글꼴 일치기가 고정 피치 글꼴을 선호합니다.
QFont::Courier2TypeWriter 의 동의어입니다.
QFont::OldEnglish3의 동의어는 글꼴 일치기가 장식 글꼴을 선호합니다.
QFont::DecorativeOldEnglishOldEnglish 의 동의어입니다.
QFont::Monospace7글꼴 일치기는 CSS 일반 글꼴 패밀리 '모노스페이스'에 매핑되는 글꼴을 선호합니다.
QFont::Fantasy8글꼴 일치기는 CSS 일반 글꼴 패밀리 'fantasy'에 매핑되는 글꼴을 선호합니다.
QFont::Cursive6글꼴 일치기는 CSS 일반 글꼴 패밀리 '필기체'에 매핑되는 글꼴을 선호합니다.
QFont::System4글꼴 일치기는 시스템 글꼴을 선호합니다.

enum QFont::StyleStrategy

스타일 전략은 font matching 알고리즘에 적절한 기본 서체군을 찾기 위해 어떤 유형의 서체를 사용해야 하는지 알려줍니다.

다음과 같은 전략을 사용할 수 있습니다:

Constant설명
QFont::PreferDefault0x0001기본 스타일 전략입니다. 어떤 유형의 글꼴도 선호하지 않습니다.
QFont::PreferBitmap0x0002비트맵 글꼴을 선호합니다(윤곽선 글꼴과 반대).
QFont::PreferDevice0x0004디바이스 글꼴을 선호합니다.
QFont::PreferOutline0x0008윤곽선 글꼴을 선호합니다(비트맵 글꼴과 반대).
QFont::ForceOutline0x0010윤곽선 글꼴을 강제로 사용합니다.
QFont::NoAntialias0x0100글꼴을 안티앨리어싱하지 않습니다.
QFont::NoSubpixelAntialias0x0800가능하면 글꼴의 서브픽셀 앤티앨리어싱을 피합니다.
QFont::PreferAntialias0x0080가능하면 앤티앨리어싱을 적용합니다.
QFont::ContextFontMerging (since Qt 6.8)0x2000선택한 글꼴에 특정 문자가 포함되어 있지 않으면, Qt는 자동으로 해당 문자가 포함된 비슷한 모양의 대체 글꼴을 선택합니다. 기본적으로 이 작업은 문자 단위로 수행됩니다. 즉, 흔하지 않은 특정 경우에는 동일한 스크립트에 있더라도 하나의 텍스트 문자열을 표현하기 위해 여러 글꼴이 사용될 수 있습니다. ContextFontMerging 을 설정하면 입력 문자열의 가장 큰 하위 집합과 일치하는 대체 글꼴을 찾으려고 시도합니다. 이 경우 누락된 글리프가 있는 문자열의 경우 비용이 더 많이 들지만 보다 일관된 결과를 얻을 수 있습니다. NoFontMerging 이 설정되어 있으면 ContextFontMerging 은 아무런 영향을 미치지 않습니다.
QFont::PreferTypoLineMetrics (since Qt 6.8)0x4000호환성을 위해 OpenType 글꼴에는 글꼴의 ascent, descentleading 을 제공하는 두 개의 경쟁하는 세로줄 메트릭 세트가 포함되어 있습니다. 이를 흔히 (Windows) 메트릭과 타이포 (오타) 메트릭이라고 합니다. 사양에서는 줄 간격에 typo 메트릭을 사용할 것을 권장하지만, 글꼴의 fsSelection 필드에 USE_TYPO_METRICS 플래그가 설정되어 있지 않은 한 많은 애플리케이션에서 win 메트릭을 선호합니다. 이는 이전 버전과의 호환성을 위해 Qt 애플리케이션에서도 마찬가지입니다. typo 메트릭이 유효함을 나타내기 위해 USE_TYPO_METRICS 플래그를 설정한 글꼴이나 win 메트릭과 typo 메트릭이 일치하는 글꼴의 경우에는 문제가 되지 않습니다. 그러나 특정 글꼴의 경우 win 메트릭이 바람직한 줄 간격보다 클 수 있으며 실수로 USE_TYPO_METRICS 플래그가 설정되지 않을 수 있습니다. 이러한 글꼴의 경우 PreferTypoLineMetrics 을 설정하면 더 나은 결과를 얻을 수 있습니다.
QFont::NoFontMerging0x8000특정 문자 시스템에 대해 선택된 글꼴에 그리도록 요청된 문자가 포함되어 있지 않은 경우, Qt는 자동으로 해당 문자가 포함된 비슷한 모양의 글꼴을 선택합니다. NoFontMerging 플래그는 이 기능을 비활성화합니다. 이 플래그를 활성화해도 선택한 글꼴이 텍스트의 쓰기 시스템을 지원하지 않을 때 Qt가 자동으로 적합한 글꼴을 선택하는 것을 막지는 못한다는 점에 유의하십시오.
QFont::PreferNoShaping0x1000때로는 글꼴이 문자를 올바르게 표시하기 위해 복잡한 규칙을 문자 집합에 적용하는 경우가 있습니다. 브라만 문자와 같은 일부 문자 체계에서는 텍스트를 읽기 위해 이 기능이 필요하지만 라틴 문자와 같은 문자 체계에서는 단지 외형적인 기능일 뿐입니다. PreferNoShaping 플래그는 필요하지 않은 경우 이러한 모든 기능을 비활성화하여 대부분의 경우 성능을 향상시킵니다(Qt 5.10 이후).

이 플래그 중 하나를 사용하여 OR할 수 있습니다:

Constant설명
QFont::PreferMatch0x0020정확한 일치를 선호합니다. 글꼴 일치기는 지정한 정확한 글꼴 크기를 사용하려고 시도합니다.
QFont::PreferQuality0x0040최고 품질의 글꼴을 선호합니다. 글꼴 일치기는 글꼴이 지원하는 가장 가까운 표준 포인트 크기를 사용합니다.

enum QFont::Weight

Qt는 OpenType과 호환되는 1에서 1000까지의 가중치 스케일을 사용합니다. 가중치가 1이면 가늘고, 1000이면 매우 검은색입니다.

이 열거형에는 미리 정의된 글꼴 가중치가 포함되어 있습니다:

Constant설명
QFont::Thin100100
QFont::ExtraLight200200
QFont::Light300300
QFont::Normal400400
QFont::Medium500500
QFont::DemiBold600600
QFont::Bold700700
QFont::ExtraBold800800
QFont::Black900900

멤버 기능 문서

QFont::QFont()

애플리케이션의 기본 글꼴을 사용하는 글꼴 객체를 구축합니다.

QGuiApplication::setFont() 및 QGuiApplication::font()도 참조하세요 .

QFont::QFont(const QFont &font, const QPaintDevice *pd)

페인트 장치에서 사용하기 위해 font 에서 글꼴을 작성합니다 pd.

QFont::QFont(const QString &family, int pointSize = -1, int weight = -1, bool italic = false)

지정된 family, pointSize, weightitalic 설정으로 글꼴 객체를 생성합니다.

pointSize 이 0이거나 음수이면 글꼴의 포인트 크기가 시스템에 따라 달라지는 기본값으로 설정됩니다. 일반적으로 이 값은 12포인트입니다.

family 이름에는 선택적으로 파운드리 이름(예: "Helvetica [Cronyx]")을 포함할 수도 있습니다. family 를 두 개 이상의 파운드리에서 사용할 수 있고 파운드리가 지정되지 않은 경우 임의의 파운드리가 선택됩니다. 해당 제품군을 사용할 수 없는 경우 font matching 알고리즘을 사용하여 제품군이 설정됩니다.

그러면 쉼표로 패밀리 문자열을 분할하고 결과 목록으로 setFamilies()를 호출합니다. 이름에 쉼표를 사용하는 글꼴을 유지하려면 QStringList 를 받는 생성자를 사용합니다.

Weight, setFamily(), setPointSize(), setWeight(), setItalic(), setStyleHint(), setFamilies() 및 QGuiApplication::font()도 참조하세요 .

[explicit] QFont::QFont(const QStringList &families, int pointSize = -1, int weight = -1, bool italic = false)

지정된 families, pointSize, weightitalic 설정으로 글꼴 객체를 생성합니다.

pointSize 이 0이거나 음수이면 글꼴의 포인트 크기가 시스템에 따라 달라지는 기본값으로 설정됩니다. 일반적으로 이 값은 12포인트입니다.

families 의 각 패밀리 이름 항목에는 선택적으로 파운드리 이름(예: "Helvetica [Cronyx]")도 포함할 수 있습니다. 두 개 이상의 파운드리에서 제품군을 사용할 수 있고 파운드리가 지정되지 않은 경우 임의의 파운드리가 선택됩니다. 해당 제품군을 사용할 수 없는 경우 font matching 알고리즘을 사용하여 제품군이 설정됩니다.

Weight, setPointSize(), setWeight(), setItalic(), setStyleHint(), setFamilies(), QGuiApplication::font()도 참조하세요 .

QFont::QFont(const QFont &font)

font 의 복사본인 글꼴을 생성합니다.

[noexcept] QFont::~QFont()

글꼴 개체를 파괴하고 할당된 모든 리소스를 해제합니다.

bool QFont::bold() const

weight()이 QFont::Medium 보다 큰 값이면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

weight(), setBold() 및 QFontInfo::bold()도 참조하세요 .

QFont::Capitalization QFont::capitalization() const

글꼴의 현재 대문자 유형을 반환합니다.

setCapitalization()도 참조하세요 .

[since 6.7] void QFont::clearFeatures()

QFont 에서 이전에 설정한 모든 기능을 지웁니다.

글꼴 기능에 대한 자세한 내용은 setFeature()를 참조하십시오.

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

QFont::Tag, setFeature(), unsetFeature(), featureTags() 및 featureValue()도 참조하세요 .

[since 6.7] void QFont::clearVariableAxes()

QFont 에서 이전에 설정한 가변 축 값을 모두 지웁니다.

가변 축에 대한 자세한 내용은 setVariableAxis()를 참조하십시오.

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

QFont::Tag, setVariableAxis(), unsetVariableAxis(), isVariableAxisSet() 및 variableAxisValue()도 참조하십시오 .

QString QFont::defaultFamily() const

현재 스타일 힌트에 해당하는 패밀리 이름을 반환합니다.

StyleHint, styleHint() 및 setStyleHint()도 참조하세요 .

bool QFont::exactMatch() const

이 글꼴의 설정과 정확히 일치하는 창 시스템 글꼴을 사용할 수 있는 경우 true 을 반환합니다.

QFontInfo도 참조하세요 .

QStringList QFont::families() const

요청된 글꼴 패밀리 이름, 즉 마지막 setFamilies() 호출 또는 생성자를 통해 설정된 이름을 반환합니다. 그렇지 않으면 빈 목록을 반환합니다.

setFamily(), setFamilies(), family(), substitutes() 및 substitute()도 참조하세요 .

QString QFont::family() const

요청된 글꼴 패밀리 이름을 반환합니다. 이는 항상 families() 호출의 첫 번째 항목과 동일합니다.

setFamily(), substitutes(), substitute(), setFamilies() 및 families()도 참조하세요 .

[since 6.7] QList<QFont::Tag> QFont::featureTags() const

현재 설정된 모든 글꼴 기능에 대한 태그 목록을 반환합니다 QFont.

글꼴 기능에 대한 자세한 내용은 setFeature()를 참조하십시오.

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

QFont::Tag, setFeature(), unsetFeature(), isFeatureSet() 및 clearFeatures()도 참조하십시오 .

[since 6.7] quint32 QFont::featureValue(QFont::Tag tag) const

특정 기능에 설정된 값을 반환합니다 tag. 태그가 설정되지 않은 경우 0이 대신 반환됩니다.

글꼴 기능에 대한 자세한 내용은 setFeature()를 참조하세요.

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

QFont::Tag, setFeature(), unsetFeature(), featureTags() 및 isFeatureSet()도 참조하세요 .

bool QFont::fixedPitch() const

고정 피치가 설정된 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

setFixedPitch() 및 QFontInfo::fixedPitch()도 참조하세요 .

bool QFont::fromString(const QString &descrip)

설명 descrip 과 일치하도록 이 글꼴을 설정합니다. 설명은 toString()에서 반환되는 쉼표로 구분된 글꼴 속성 목록입니다.

toString()도 참조하세요 .

QFont::HintingPreference QFont::hintingPreference() const

이 글꼴로 렌더링된 글리프에 대해 현재 선호되는 힌트 레벨을 반환합니다.

setHintingPreference()도 참조하세요 .

[static] void QFont::insertSubstitution(const QString &familyName, const QString &substituteName)

familyName 패밀리 대체 테이블에 substituteName 을 삽입합니다.

글꼴을 대체한 후 모든 QFont 객체를 삭제하고 다시 생성하여 글꼴 업데이트를 트리거합니다.

insertSubstitutions(), removeSubstitutions(), substitutions(), substitute() 및 substitutes()도 참조하세요 .

[static] void QFont::insertSubstitutions(const QString &familyName, const QStringList &substituteNames)

familyName 의 대체 목록에 substituteNames 패밀리 목록을 삽입합니다.

글꼴을 대체한 후 모든 QFont 객체를 삭제하고 다시 생성하여 글꼴 업데이트를 트리거합니다.

insertSubstitution(), removeSubstitutions(), substitutions() 및 substitute()도 참조하세요 .

bool QFont::isCopyOf(const QFont &f) const

이 글꼴과 f 이 서로의 복사본인 경우, 즉 둘 중 하나가 다른 글꼴의 복사본으로 생성되었고 이후 수정된 적이 없는 경우 true 을 반환합니다. 이것은 동일성보다 훨씬 엄격합니다.

operator=() 및 operator==()도 참조하세요 .

[since 6.7] bool QFont::isFeatureSet(QFont::Tag tag) const

tag 에 지정된 기능의 값이 QFont 에 설정되어 있으면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

글꼴 기능에 대한 자세한 내용은 setFeature()를 참조하십시오.

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

QFont::Tag, setFeature(), unsetFeature(), featureTags() 및 featureValue()도 참조하십시오 .

[since 6.7] bool QFont::isVariableAxisSet(QFont::Tag tag) const

tag 에 지정된 가변 축의 값이 QFont 에 설정되어 있으면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

글꼴 가변 축에 대한 자세한 내용은 setVariableAxis()를 참조하십시오.

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

QFont::Tag, setVariableAxis(), unsetVariableAxis(), variableAxisValue() 및 clearVariableAxes()도 참조하십시오 .

bool QFont::italic() const

글꼴의 style()이 아닌 경우 true 을 반환합니다. QFont::StyleNormal

setItalic() 및 style()도 참조하세요 .

bool QFont::kerning() const

이 글꼴로 텍스트를 그릴 때 커닝을 사용해야 하는 경우 true 을 반환합니다.

setKerning()도 참조하세요 .

QString QFont::key() const

글꼴의 텍스트 표현인 글꼴의 키를 반환합니다. 일반적으로 폰트 캐시 또는 폰트 사전의 키로 사용됩니다.

QMap참조하세요 .

qreal QFont::letterSpacing() const

글꼴의 문자 간격을 반환합니다.

setLetterSpacing(), letterSpacingType() 및 setWordSpacing()도 참조하세요 .

QFont::SpacingType QFont::letterSpacingType() const

문자 간격에 사용되는 간격 유형을 반환합니다.

letterSpacing(), setLetterSpacing() 및 setWordSpacing()도 참조하세요 .

bool QFont::overline() const

오버라인이 설정된 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

setOverline()도 참조하세요 .

int QFont::pixelSize() const

setPixelSize()로 설정된 경우 글꼴의 픽셀 크기를 반환합니다. 크기가 setPointSize() 또는 setPointSizeF()로 설정된 경우 -1을 반환합니다.

setPixelSize(), pointSize(), QFontInfo::pointSize() 및 QFontInfo::pixelSize()도 참조하세요 .

int QFont::pointSize() const

글꼴의 포인트 크기를 반환합니다. 글꼴 크기가 픽셀 단위로 지정된 경우 -1을 반환합니다.

setPointSize() 및 pointSizeF()도 참조하세요 .

qreal QFont::pointSizeF() const

글꼴의 포인트 크기를 반환합니다. 글꼴 크기를 픽셀 단위로 지정한 경우 -1을 반환합니다.

pointSize(), setPointSizeF(), pixelSize(), QFontInfo::pointSize() 및 QFontInfo::pixelSize()도 참조하세요 .

[static] void QFont::removeSubstitutions(const QString &familyName)

familyName 에 대한 모든 대체를 제거합니다.

insertSubstitutions(), insertSubstitution(), substitutions() 및 substitute()도 참조하세요 .

QFont QFont::resolve(const QFont &other) const

이 글꼴에 이전에 설정되지 않은 속성이 other 에서 복사된 새 QFont 을 반환합니다.

void QFont::setBold(bool enable)

enable 이 참이면 글꼴의 가중치를 QFont::Bold 으로 설정하고, 그렇지 않으면 가중치를 QFont::Normal 으로 설정합니다.

더 세밀한 굵기 제어를 위해서는 setWeight()를 사용합니다.

참고: styleName()가 설정되어 있으면 이 값이 무시되거나 플랫폼에서 지원되는 경우 글꼴이 인위적으로 굵게 처리될 수 있습니다.

bold() 및 setWeight()도 참조하세요 .

void QFont::setCapitalization(QFont::Capitalization caps)

이 글꼴의 텍스트 대문자를 caps 로 설정합니다.

글꼴의 대문자화는 텍스트가 선택한 대문자 모드로 표시되도록 합니다.

capitalization()도 참조하세요 .

void QFont::setFamilies(const QStringList &families)

글꼴의 패밀리 이름 목록을 설정합니다. 이름은 대소문자를 구분하지 않으며 파운드리 이름을 포함할 수 있습니다. families 의 첫 번째 패밀리가 글꼴의 기본 패밀리로 설정됩니다.

families 의 각 패밀리 이름 항목에는 선택적으로 파운드리 이름(예: "Helvetica [Cronyx]")도 포함될 수 있습니다. 두 개 이상의 파운드리에서 패밀리 사용 가능하지만 파운드리가 지정되지 않은 경우 임의의 파운드리가 선택됩니다. 해당 제품군을 사용할 수 없는 경우 font matching 알고리즘을 사용하여 제품군이 설정됩니다.

family(), families(), setFamily(), setStyleHint() 및 QFontInfo참조하세요 .

void QFont::setFamily(const QString &family)

글꼴의 패밀리 이름을 설정합니다. 이름은 대소문자를 구분하지 않으며 파운드리 이름을 포함할 수 있습니다.

family 이름에는 선택적으로 파운드리 이름(예: "Helvetica [Cronyx]")을 포함할 수도 있습니다. family 에 두 개 이상의 파운드리를 사용할 수 있고 파운드리가 지정되지 않은 경우 임의의 파운드리가 선택됩니다. 해당 제품군을 사용할 수 없는 경우 font matching 알고리즘을 사용하여 제품군이 설정됩니다.

family(), setStyleHint(), setFamilies(), families() 및 QFontInfo참조하세요 .

[since 6.7] void QFont::setFeature(QFont::Tag tag, quint32 value)

이 함수는 오버로드된 함수입니다.

텍스트 모양을 만들 때 tag 에 지정된 타이포그래피 기능에 정수 값을 적용합니다. 이를 통해 글꼴 모양을 만드는 프로세스에 대한 고급 액세스를 제공하며, API에서 다루지 않는 글꼴 기능을 지원하는 데 사용할 수 있습니다.

이 기능은 일반적으로 글꼴 기능 맵의 4자 기능 이름으로 인코딩된 tag 으로 지정됩니다.

대부분의 경우 태그와 함께 전달되는 이 정수 value 는 부울 값을 나타냅니다: 0 값은 해당 기능이 비활성화되어 있음을 의미하고, 0이 아닌 값은 활성화되어 있음을 의미합니다. 그러나 특정 글꼴 기능의 경우 다른 해석을 가질 수 있습니다. 예를 들어 salt 기능에 적용된 경우 이 값은 사용할 스타일 대체를 지정하는 인덱스입니다.

예를 들어 frac 글꼴 기능은 슬래시로 구분된 대각선 분수(예: 1/2)를 다른 표현으로 변환합니다. 일반적으로 전체 분수를 단일 문자 너비(예: ½)로 굽는 작업이 포함됩니다.

글꼴이 frac 기능을 지원하는 경우 글꼴 기능 맵에서 features["frac"] = 1 을 설정하여 셰이퍼에서 활성화할 수 있습니다.

참고: 기본적으로 Qt는 다른 글꼴 속성에 따라 특정 글꼴 기능을 활성화 및 비활성화합니다. 특히 kern 기능은 QFontkerning() 속성에 따라 활성화/비활성화됩니다. 또한 letterSpacing()이 적용되면 모든 합자 기능(liga, clig, dlig, hlig)이 비활성화되지만, 이는 합자를 사용하는 것이 장식적인 글쓰기 시스템에 대해서만 해당됩니다. 합자가 필요한 쓰기 시스템의 경우 기능은 기본 상태로 유지됩니다. setFeature() 및 관련 함수를 사용하여 설정한 값은 기본 동작을 재정의합니다. 예를 들어 "kern" 기능이 1로 설정되어 있으면 커닝 속성이 false로 설정되어 있는지 여부에 관계없이 커닝이 항상 활성화됩니다. 마찬가지로 0으로 설정되어 있으면 항상 비활성화됩니다. 글꼴 기능을 기본 동작으로 재설정하려면 unsetFeature()를 사용하여 설정을 해제할 수 있습니다.

이 기능은 Qt 6.7에 도입되었습니다.

QFont::Tag, clearFeatures(), setFeature(), unsetFeature() 및 featureTags()도 참조하세요 .

void QFont::setFixedPitch(bool enable)

enable 이 참이면 고정 피치를 켜고, 그렇지 않으면 고정 피치를 끕니다.

fixedPitch() 및 QFontInfo도 참조하세요 .

void QFont::setHintingPreference(QFont::HintingPreference hintingPreference)

글리프의 힌트 수준에 대한 기본 설정을 hintingPreference 으로 설정합니다. 이는 기본 글꼴 렌더링 시스템에 특정 수준의 힌트를 사용하라는 힌트이며 플랫폼에 따라 지원 여부가 다릅니다. 자세한 내용은 QFont::HintingPreference 설명서의 표를 참조하세요.

기본 힌트 기본 설정은 QFont::PreferDefaultHinting 입니다.

hintingPreference()도 참조하세요 .

void QFont::setItalic(bool enable)

enable 이 참이면 글꼴의 style()를 QFont::StyleItalic 으로 설정하고, 그렇지 않으면 스타일을 QFont::StyleNormal 으로 설정합니다.

참고: styleName()가 설정되어 있으면 이 값이 무시되거나 플랫폼에서 지원되는 경우 디자인된 이탤릭체 글꼴 변형이 선택되는 대신 글꼴이 기울어져 렌더링될 수 있습니다.

italic() 및 QFontInfo참조하세요 .

void QFont::setKerning(bool enable)

enable 가 참이면 이 글꼴에 대해 커닝을 활성화하고, 그렇지 않으면 비활성화합니다. 기본적으로 커닝은 활성화되어 있습니다.

커닝이 활성화되면 라틴 텍스트의 경우에도 글리프 메트릭이 더 이상 합산되지 않습니다. 즉, width('a') + width('b')가 width("ab")와 같다는 가정이 반드시 참이 아니라는 뜻입니다.

kerning() 및 QFontMetrics참조하세요 .

void QFont::setLetterSpacing(QFont::SpacingType type, qreal spacing)

글꼴의 글자 간격을 spacing 으로 설정하고 간격 유형을 type 으로 설정합니다.

글자 간격은 글꼴의 개별 글자 사이의 기본 간격을 변경합니다. 선택한 간격 유형에 따라 글자 사이의 간격을 문자 너비의 백분율 또는 픽셀 단위로 더 작게 만들거나 더 크게 만들 수 있습니다.

letterSpacing(), letterSpacingType() 및 setWordSpacing()도 참조하세요 .

void QFont::setOverline(bool enable)

enable 이 참이면 오버라인을 설정하고, 그렇지 않으면 오버라인을 해제합니다.

overline() 및 QFontInfo참조하세요 .

void QFont::setPixelSize(int pixelSize)

글꼴 크기를 pixelSize 픽셀로 설정하고 최대 크기는 부호 없는 16비트 정수로 설정합니다.

이 함수를 사용하면 글꼴이 디바이스에 종속됩니다. setPointSize () 또는 setPointSizeF()를 사용하여 장치에 독립적으로 글꼴 크기를 설정합니다.

pixelSize()도 참조하세요 .

void QFont::setPointSize(int pointSize)

포인트 크기를 pointSize 로 설정합니다. 포인트 크기는 0보다 커야 합니다.

pointSize() 및 setPointSizeF()도 참조하세요 .

void QFont::setPointSizeF(qreal pointSize)

포인트 크기를 pointSize 로 설정합니다. 포인트 크기는 0보다 커야 합니다. 모든 플랫폼에서 요청된 정밀도가 달성되지 않을 수 있습니다.

pointSizeF(), setPointSize() 및 setPixelSize()도 참조하세요 .

void QFont::setStretch(int factor)

글꼴의 늘이기 비율을 설정합니다.

스트레치 계수는 글꼴의 압축 또는 확장 버전과 일치하거나 글꼴의 모든 문자 너비를 factor 퍼센트만큼 변경하는 스트레치 변환을 적용합니다. 예를 들어 factor 을 150으로 설정하면 글꼴의 모든 문자가 1.5배(즉, 150%) 더 넓어집니다. 최소 스트레치 계수는 1이고 최대 스트레치 계수는 4000입니다. 기본 스트레치 계수는 AnyStretch 으로, 모든 스트레치 계수를 허용하고 글꼴에 어떤 변형도 적용하지 않습니다.

스트레치 계수는 윤곽선 글꼴에만 적용됩니다. 비트맵 글꼴에는 스트레치 계수가 무시됩니다.

참고: 기본이 아닌 기본 스트레치 계수가 있는 글꼴과 일치하는 경우 100의 스트레치를 요청하면 중간 너비 글꼴로 다시 늘어납니다.

stretch() 및 QFont::Stretch참조하세요 .

void QFont::setStrikeOut(bool enable)

enable 이 참이면 스트라이크 아웃을 설정하고, 그렇지 않으면 스트라이크 아웃을 해제합니다.

strikeOut() 및 QFontInfo도 참조하세요 .

void QFont::setStyle(QFont::Style style)

글꼴 스타일을 style 로 설정합니다.

style(), italic() 및 QFontInfo참조하세요 .

void QFont::setStyleHint(QFont::StyleHint hint, QFont::StyleStrategy strategy = PreferDefault)

스타일 힌트와 전략을 각각 hintstrategy 으로 설정합니다.

명시적으로 설정하지 않으면 스타일 힌트는 AnyStyle, 스타일 전략은 PreferDefault 으로 기본 설정됩니다.

이 정보는 윈도우 시스템에서 제공되지 않기 때문에 Qt는 X11에서 스타일 힌트를 지원하지 않습니다.

StyleHint, styleHint(), StyleStrategy, styleStrategy() 및 QFontInfo참조하십시오 .

void QFont::setStyleName(const QString &styleName)

글꼴의 스타일 이름을 styleName 로 설정합니다. 설정하면 style() 및 weight()와 같은 다른 스타일 속성은 글꼴 일치 시 무시되지만 플랫폼의 글꼴 엔진에서 지원하는 경우 나중에 시뮬레이션될 수 있습니다.

인위적으로 시뮬레이션된 스타일의 품질이 낮고 크로스 플랫폼이 완벽하게 지원되지 않기 때문에 스타일 속성별 일치와 함께 스타일 이름별 일치를 사용하지 않는 것이 좋습니다.

styleName()도 참조하세요 .

void QFont::setStyleStrategy(QFont::StyleStrategy s)

글꼴의 스타일 전략을 s 로 설정합니다.

styleStrategy() 및 QFont::StyleStrategy참조하세요 .

void QFont::setUnderline(bool enable)

enable 이 참이면 밑줄을 설정하고, 그렇지 않으면 밑줄을 해제합니다.

underline() 및 QFontInfo참조하세요 .

[since 6.7] void QFont::setVariableAxis(QFont::Tag tag, float value)

tag 에 해당하는 가변 축에 value 을 적용합니다.

가변 글꼴은 동일한 글꼴 파일에 가중치, 너비 또는 스타일이 다른 여러 가지 변형을 저장할 수 있는 방법을 제공합니다. 변형은 "가변 축"이라고 하는 사전 정의된 매개변수 집합에 대한 부동 소수점 값으로 제공됩니다. 특정 인스턴스는 일반적으로 폰트 디자이너가 이름을 지정하며, Qt에서는 기존 하위 패밀리처럼 setStyleName()를 사용하여 선택할 수 있습니다.

어떤 경우에는 다른 축에 임의의 값을 제공하는 것도 유용합니다. 예를 들어, 글꼴에 일반과 굵게 하위 패밀리가 있는 경우 이 사이에 가중치를 지정하고 싶을 수 있습니다. 그런 다음 글꼴의 "wght" 축에 사용자 지정 값을 제공하여 이를 수동으로 요청할 수 있습니다.

QFont font;
font.setVariableAxis("wght", (QFont::Normal + QFont::Bold) / 2.0f);

글꼴에서 "wght" 축이 지원되고 지정된 값이 정의된 범위 내에 있으면 가중치 550.0에 해당하는 글꼴이 제공됩니다.

많은 글꼴이 제공하는 표준 축은 "wght"(무게), "wdth"(너비), "ital"(이탤릭체), "opsz"(광학 크기) 등 몇 가지가 있습니다. 이러한 글꼴에는 각각 글꼴 자체에 정의된 개별 범위가 있습니다. 예를 들어 'wght'는 100~900(QFont::Thin ~ QFont::Black) 범위인 반면 'ital'은 0~1(이탤릭체 없음에서 완전 이탤릭체까지) 범위일 수 있습니다.

글꼴은 사용자 정의 축을 정의하도록 선택할 수도 있습니다. 유일한 제한은 이름이 QFont::Tag (라틴 1 문자 4개로 구성된 시퀀스)의 요구 사항을 충족해야 한다는 것입니다.

기본적으로 가변 축은 설정되어 있지 않습니다.

참고: Windows에서 선택적 GDI 글꼴 백엔드를 사용 중인 경우 가변 축이 지원되지 않습니다.

이 기능은 Qt 6.7에 도입되었습니다.

unsetVariableAxis참조하세요 .

void QFont::setWeight(QFont::Weight weight)

QFont::Weight 열거형에 정의된 눈금을 사용하여 글꼴의 가중치를 weight 로 설정합니다.

참고: styleName()가 설정되어 있으면 글꼴 선택 시 이 값이 무시될 수 있습니다.

weight() 및 QFontInfo참조하세요 .

void QFont::setWordSpacing(qreal spacing)

글꼴의 단어 간격을 spacing 으로 설정합니다.

단어 간격은 개별 단어 사이의 기본 간격을 변경합니다. 양수 값은 해당 픽셀만큼 단어 간격을 늘리고 음수 값은 그에 따라 단어 간 간격을 줄입니다.

단어 간격은 개별 단어가 공백으로 구분되지 않는 쓰기 시스템에는 적용되지 않습니다.

wordSpacing() 및 setLetterSpacing()도 참조하세요 .

int QFont::stretch() const

글꼴의 스트레치 계수를 반환합니다.

setStretch()도 참조하세요 .

bool QFont::strikeOut() const

삼진아웃이 설정된 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

setStrikeOut()도 참조하세요 .

QFont::Style QFont::style() const

글꼴의 스타일을 반환합니다.

setStyle()도 참조하세요 .

QFont::StyleHint QFont::styleHint() const

StyleHint 을 반환합니다.

스타일 힌트는 font matching algorithm 에 영향을 줍니다. 사용 가능한 힌트 목록은 QFont::StyleHint 을 참조하세요.

setStyleHint(), QFont::StyleStrategy, QFontInfo::styleHint()도 참조하세요 .

QString QFont::styleName() const

요청된 글꼴 스타일 이름을 반환합니다. 다른 스타일 속성에서 정규화할 수 없는 불규칙한 스타일과 글꼴을 일치시키는 데 사용할 수 있습니다.

setStyleName(), setFamily() 및 setStyle()도 참조하세요 .

QFont::StyleStrategy QFont::styleStrategy() const

StyleStrategy 을 반환합니다.

스타일 전략은 font matching 알고리즘에 영향을 줍니다. 사용 가능한 전략 목록은 QFont::StyleStrategy 을 참조하세요.

setStyleStrategy(), setStyleHint() 및 QFont::StyleHint참조하세요 .

[static] QString QFont::substitute(const QString &familyName)

familyName 을 지정할 때마다 사용할 첫 번째 패밀리 이름을 반환합니다. 이 조회는 대소문자를 구분하지 않습니다.

familyName 를 대체할 수 없는 경우 familyName 이 반환됩니다.

대체 목록을 얻으려면 substitutes()를 사용합니다.

setFamily(), insertSubstitutions(), insertSubstitution() 및 removeSubstitutions()도 참조하세요 .

[static] QStringList QFont::substitutes(const QString &familyName)

familyName 을 지정할 때마다 사용할 패밀리 이름 목록을 반환합니다. 이 조회는 대소문자를 구분하지 않습니다.

familyName 를 대체할 수 없는 경우 빈 목록이 반환됩니다.

substitute(), insertSubstitutions(), insertSubstitution() 및 removeSubstitutions()도 참조하세요 .

[static] QStringList QFont::substitutions()

대체된 성의 정렬된 목록을 반환합니다.

insertSubstitution(), removeSubstitutions() 및 substitute()도 참조하세요 .

[noexcept] void QFont::swap(QFont &other)

이 글꼴 인스턴스를 other 로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.

QString QFont::toString() const

글꼴에 대한 설명을 반환합니다. 설명은 쉼표로 구분된 속성 목록으로 QSettings 에서 사용하기에 적합하며 다음과 같이 구성됩니다:

  • 글꼴 패밀리
  • 포인트 크기
  • 픽셀 크기
  • 스타일 힌트
  • 글꼴 무게
  • 글꼴 스타일
  • 밑줄
  • 스트라이크 아웃
  • 고정 피치
  • 항상 0
  • 대문자
  • 문자 간격
  • 단어 간격
  • Stretch
  • 스타일 전략
  • 글꼴 스타일(사용할 수 없는 경우 생략)

fromString()도 참조하세요 .

bool QFont::underline() const

밑줄이 설정된 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

setUnderline()도 참조하세요 .

[since 6.7] void QFont::unsetFeature(QFont::Tag tag)

이 함수는 과부하된 함수입니다.

명시적으로 활성화/비활성화된 기능 맵에서 tag 을 설정 해제합니다.

참고: 기능이 이전에 추가되지 않았더라도 이 QFont 에서 글꼴 기능 맵이 수정된 것으로 표시되어 다른 글꼴에 대해 확인할 때 우선적으로 적용됩니다.

QFont 에서 기존 기능을 설정 해제하면 동작이 기본값으로 되돌아갑니다.

글꼴 기능에 대한 자세한 내용은 setFeature()를 참조하세요.

이 기능은 Qt 6.7에 도입되었습니다.

QFont::Tag, clearFeatures(), setFeature(), featureTags() 및 featureValue()도 참조하세요 .

[since 6.7] void QFont::unsetVariableAxis(QFont::Tag tag)

tag 에 의해 이전에 설정된 가변 축 값을 설정 해제합니다.

참고: 이 태그에 이전에 값이 지정되지 않은 경우, QFont 은 다른 QFont 값과 비교할 때 여전히 가변 축이 설정된 것으로 간주합니다.

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

setVariableAxis도 참조하십시오 .

[since 6.7] QList<QFont::Tag> QFont::variableAxisTags() const

현재 이 QFont 에 설정된 모든 가변 축에 대한 태그 목록을 반환합니다.

가변 축에 대한 자세한 내용은 setVariableAxis()를 참조하십시오.

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

QFont::Tag, setVariableAxis(), unsetVariableAxis(), isVariableAxisSet() 및 clearVariableAxes()도 참조하십시오 .

[since 6.7] float QFont::variableAxisValue(QFont::Tag tag) const

특정 가변 축에 설정된 값을 반환합니다 tag. 태그가 설정되지 않은 경우 0.0이 대신 반환됩니다.

가변 축에 대한 자세한 내용은 setVariableAxis()를 참조하십시오.

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

QFont::Tag, setVariableAxis(), unsetVariableAxis(), isVariableAxisSet() 및 clearVariableAxes()도 참조하세요 .

QFont::Weight QFont::weight() const

QFont::Weight 열거형과 동일한 스케일을 사용하여 글꼴의 가중치를 반환합니다.

setWeight(), Weight, QFontInfo도 참조하세요 .

qreal QFont::wordSpacing() const

글꼴의 단어 간격을 반환합니다.

setWordSpacing() 및 setLetterSpacing()도 참조하세요 .

QVariant QFont::operator QVariant() const

글꼴을 QVariant

bool QFont::operator!=(const QFont &f) const

이 글꼴이 f 과 다르면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

글꼴 속성이 다른 경우 두 QFonts는 서로 다른 것으로 간주됩니다.

operator==()도 참조하십시오 .

bool QFont::operator<(const QFont &f) const

이 글꼴과 f 글꼴을 임의로 비교합니다. 보장되는 것은 두 글꼴이 같으면 false 을 반환하고, 글꼴이 같지 않으면 (f1 < f2) == !(f2 < f1)을 반환한다는 것입니다.

이 함수는 QMap 에서 QFont 객체를 키로 사용하려는 경우와 같이 일부 상황에서 유용합니다.

operator==(), operator!=() 및 isCopyOf()도 참조하세요 .

[noexcept] QFont &QFont::operator=(QFont &&other)

이동-이 other 인스턴스를 QFont 인스턴스에 할당합니다.

QFont &QFont::operator=(const QFont &font)

이 글꼴에 font 을 할당하고 참조를 반환합니다.

bool QFont::operator==(const QFont &f) const

이 글꼴이 f 과 같으면 true 을 반환하고, 그렇지 않으면 false 를 반환합니다.

글꼴 속성이 같으면 두 QFonts는 같은 것으로 간주됩니다.

operator!=() 및 isCopyOf()도 참조하세요 .

관련 비회원

[noexcept] size_t qHash(const QFont &key, size_t seed = 0)

seed 을 사용하여 key 에 대한 해시값을 반환합니다.

QDataStream &operator<<(QDataStream &s, const QFont &font)

font 글꼴을 데이터 스트림 s 에 씁니다. (toString()는 텍스트 스트림에 씁니다.)

QDataStream 연산자의 형식을참조하십시오 .

QDataStream &operator>>(QDataStream &s, QFont &font)

데이터 스트림 s 에서 font 글꼴을 읽습니다. (fromString()는 텍스트 스트림에서 읽습니다.)

QDataStream 연산자의 형식을참조하십시오 .

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.