QTextCharFormat Class

멤버 함수 문서

QTextCharFormat::QTextCharFormat()

새로운 문자 형식 객체를 생성합니다.

QString QTextCharFormat::anchorHref() const

텍스트 형식의 하이퍼텍스트 링크를 반환하며, 설정된 링크가 없는 경우에는 빈 문자열을 반환합니다.

setAnchorHref()도 참조하십시오 .

QStringList QTextCharFormat::anchorNames() const

이 텍스트 형식과 연결된 앵커 이름을 반환하며, 설정된 앵커 이름이 없으면 빈 문자열 목록을 반환합니다. 앵커 이름이 설정되어 있는 경우, 이 형식의 텍스트는 하이퍼텍스트 링크의 대상이 될 수 있습니다.

setAnchorNames()도 참조하십시오 .

[since 6.0] qreal QTextCharFormat::baselineOffset() const

기준선 오프셋을 % 단위로 반환합니다.

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

setBaselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline()도 참조하십시오 .

QFont QTextCharFormat::font() const

이 문자 형식에 해당하는 글꼴을 반환합니다.

이 함수는 형식의 글꼴 속성(예: fontWeight() 및 fontPointSize())을 고려하여, 다음과 같이 정의된 기본 글꼴을 기반으로 이를 적용합니다. 형식이 문서의 일부인 경우, 해당 문서의 기본 글꼴이 사용됩니다. 그렇지 않은 경우, 속성은 기본 생성된 QFont 를 기반으로 적용됩니다.

예를 들어, 이 형식의 글꼴 크기가 기본 글꼴에서 변경되지 않은 경우, fontPointSize()는 0을 반환하는 반면, font().pointSize() 는 그리기에 실제로 사용된 크기를 반환합니다.

setFont() 및 QTextDocument::defaultFont()도 참조하십시오 .

QFont::Capitalization QTextCharFormat::fontCapitalization() const

글꼴의 현재 대소문자 표기 방식을 반환합니다.

setFontCapitalization()도 참조하십시오 .

QVariant QTextCharFormat::fontFamilies() const

텍스트 형식의 글꼴 패밀리를 반환합니다.

setFontFamilies() 및 font()도 참조하십시오 .

[since 6.11] QMap<QFont::Tag, quint32> QTextCharFormat::fontFeatures() const

텍스트 형식의 글꼴에 대한 서체 속성을 가져옵니다.

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

setFontFeatures()도 참조하십시오 .

bool QTextCharFormat::fontFixedPitch() const

텍스트 형식의 글꼴이 고정 폭인 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

setFontFixedPitch() 및 font()도 참조하십시오 .

QFont::HintingPreference QTextCharFormat::fontHintingPreference() const

이 텍스트 형식에 대해 설정된 힌팅 기본 설정을 반환합니다.

setFontHintingPreference(), font() 및 QFont::hintingPreference()도 참조하십시오 .

bool QTextCharFormat::fontItalic() const

텍스트 형식의 글꼴이 이탤릭체인 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.

setFontItalic() 및 font()도 참조하십시오 .

bool QTextCharFormat::fontKerning() const

글꼴 커닝이 활성화되어 있으면 true 를 반환합니다.

setFontKerning() 및 font()도 참조하십시오 .

qreal QTextCharFormat::fontLetterSpacing() const

현재 문자 간격을 반환합니다.

setFontLetterSpacing(), setFontLetterSpacingType() 및 fontLetterSpacingType()도 참조하십시오 .

QFont::SpacingType QTextCharFormat::fontLetterSpacingType() const

이 형식의 글자 간격 유형을 반환합니다.

setFontLetterSpacingType(), setFontLetterSpacing() 및 fontLetterSpacing()도 참조하십시오 .

bool QTextCharFormat::fontOverline() const

텍스트 형식의 글꼴에 위줄이 그어져 있으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

setFontOverline() 및 font()도 참조하십시오 .

qreal QTextCharFormat::fontPointSize() const

이 형식으로 텍스트를 표시하는 데 사용되는 글꼴 크기를 반환합니다.

setFontPointSize() 및 font()도 참조하십시오 .

int QTextCharFormat::fontStretch() const

현재 글꼴 확대/축소 비율을 반환합니다.

setFontStretch()도 참조하십시오 .

bool QTextCharFormat::fontStrikeOut() const

텍스트 형식의 글꼴이 취소선 처리된(가로줄이 그어져 있는) 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

setFontStrikeOut() 및 font()도 참조하십시오 .

QFont::StyleHint QTextCharFormat::fontStyleHint() const

글꼴 스타일 힌트를 반환합니다.

setFontStyleHint() 및 font()도 참조하십시오 .

QVariant QTextCharFormat::fontStyleName() const

텍스트 형식의 글꼴 스타일 이름을 반환합니다.

setFontStyleName(), font() 및 QFont::styleName()도 참조하십시오 .

QFont::StyleStrategy QTextCharFormat::fontStyleStrategy() const

현재 글꼴 스타일 전략을 반환합니다.

setFontStyleStrategy() 및 font()도 참조하십시오 .

bool QTextCharFormat::fontUnderline() const

텍스트 형식의 글꼴에 밑줄이 그어져 있으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

setFontUnderline() 및 font()도 참조하십시오 .

[since 6.11] QMap<QFont::Tag, float> QTextCharFormat::fontVariableAxes() const

텍스트 형식의 글꼴에 대한 가변 축을 가져옵니다.

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

setFontVariableAxes()도 참조하십시오 .

int QTextCharFormat::fontWeight() const

텍스트 형식의 글꼴 두께를 반환합니다.

setFontWeight(), font(), QFont::Weight도 참조하십시오 .

qreal QTextCharFormat::fontWordSpacing() const

현재 단어 간격 값을 반환합니다.

setFontWordSpacing()도 참조하십시오 .

bool QTextCharFormat::isAnchor() const

텍스트가 앵커 형식으로 서식 지정된 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

setAnchor(), setAnchorHref(), setAnchorNames()도 참조하십시오 .

bool QTextCharFormat::isValid() const

이 문자 형식이 유효하면 ` true `를 반환하고, 그렇지 않으면 `false`를 반환합니다.

void QTextCharFormat::setAnchor(bool anchor)

anchor 가 true인 경우, 이 형식을 가진 텍스트는 앵커를 나타내며 적절한 방식으로 서식이 지정됩니다. 그렇지 않은 경우 텍스트는 일반적인 방식으로 서식이 지정됩니다. (앵커는 하이퍼링크로, 대개 밑줄이 그어져 있고 일반 텍스트와 다른 색상으로 표시됩니다.)

텍스트가 렌더링되는 방식은 해당 형식에 유효한 앵커가 정의되어 있는지 여부와 무관합니다. 하이퍼텍스트 링크를 생성하려면 ` setAnchorHref()`를 사용하고, 필요에 따라 ` setAnchorNames()`를 함께 사용하십시오.

isAnchor()도 참조하십시오 .

void QTextCharFormat::setAnchorHref(const QString &value)

텍스트 형식의 하이퍼텍스트 링크를 지정된 value 로 설정합니다. 이는 일반적으로 "http://example.com/index.html"와 같은 URL입니다.

앵커는 value 을 표시 텍스트로 하여 표시됩니다. 다른 텍스트를 표시하려면 setAnchorNames()를 호출하십시오.

텍스트를 하이퍼텍스트 링크로 서식 지정하려면 setAnchor()를 사용하십시오.

anchorHref()도 참조하십시오 .

void QTextCharFormat::setAnchorNames(const QStringList &names)

텍스트 서식의 앵커 names 를 설정합니다. 앵커가 하이퍼링크로 작동하려면, setAnchorHref()를 사용하여 대상 주소를 설정하고, setAnchor()를 사용하여 앵커를 활성화해야 합니다.

anchorNames()도 참조하십시오 .

[since 6.0] void QTextCharFormat::setBaselineOffset(qreal baseline)

텍스트의 기준선(높이의 %)을 ` baseline`로 설정합니다. 양수 값을 지정하면 텍스트가 해당 백분율만큼 위로 이동하고, 음수 값을 지정하면 아래로 이동합니다. 기본값은 0입니다.

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

baselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline()도 참조하십시오 .

void QTextCharFormat::setFont(const QFont &font, QTextCharFormat::FontPropertiesInheritanceBehavior behavior = FontPropertiesAll)

텍스트 형식의 ` font`을 설정합니다.

behavior 가 QTextCharFormat::FontPropertiesAll 인 경우, 명시적으로 설정되지 않은 글꼴 속성은 기본값으로 설정된 것처럼 취급됩니다. behavior 가 QTextCharFormat::FontPropertiesSpecifiedOnly 인 경우, 명시적으로 설정되지 않은 글꼴 속성은 무시되며 해당 속성 값은 변경되지 않습니다.

font()도 참조하십시오 .

void QTextCharFormat::setFontCapitalization(QFont::Capitalization capitalization)

이 글꼴로 표시되는 텍스트의 대소문자 표기 방식을 ‘ capitalization ’로 설정합니다.

글꼴의 대소문자 설정은 텍스트가 선택된 대소문자 모드로 표시되도록 합니다.

fontCapitalization()도 참조하십시오 .

void QTextCharFormat::setFontFamilies(const QStringList &families)

텍스트 서식의 글꼴 families 을 설정합니다.

fontFamilies() 및 setFont()도 참조하십시오 .

[since 6.11] void QTextCharFormat::setFontFeatures(const QMap<QFont::Tag, quint32> &fontFeatures)

텍스트 형식의 글꼴에 대한 서체 속성을 ‘ fontFeatures ’로 설정합니다.

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

fontFeatures() 및 QFont::setFeature()도 참조하십시오 .

void QTextCharFormat::setFontFixedPitch(bool fixedPitch)

fixedPitch 가 true인 경우, 텍스트 형식의 글꼴을 고정폭 글꼴로 설정합니다. 그렇지 않은 경우 고정폭이 아닌 글꼴이 사용됩니다.

fontFixedPitch() 및 setFont()도 참조하십시오 .

void QTextCharFormat::setFontHintingPreference(QFont::HintingPreference hintingPreference)

텍스트 형식의 글꼴에 대한 힌팅 기본 설정을 ‘ hintingPreference ’으로 설정합니다.

fontHintingPreference(), setFont(), QFont::setHintingPreference()도 참조하십시오 .

void QTextCharFormat::setFontItalic(bool italic)

italic 가 true인 경우, 텍스트 형식의 글꼴을 이탤릭체로 설정합니다. 그렇지 않은 경우 글꼴은 이탤릭체가 아닙니다.

fontItalic() 및 setFont()도 참조하십시오 .

void QTextCharFormat::setFontKerning(bool enable)

enable 가 true인 경우 이 글꼴에 대해 커닝을 활성화하고, 그렇지 않은 경우 비활성화합니다.

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

fontKerning() 및 setFont()도 참조하십시오 .

void QTextCharFormat::setFontLetterSpacing(qreal spacing)

이 서식의 글자 간격을 지정된 spacing 값으로 설정합니다. 이 값의 의미는 글꼴의 글자 간격 유형에 따라 달라집니다.

백분율 간격의 경우, 값 100은 기본 간격을 나타내며, 값 200은 글자가 차지하는 공간을 두 배로 늘립니다.

fontLetterSpacing(), setFontLetterSpacingType() 및 fontLetterSpacingType()도 참조하십시오 .

void QTextCharFormat::setFontLetterSpacingType(QFont::SpacingType letterSpacingType)

이 형식의 글자 간격 유형을 ‘ letterSpacingType ’로 설정합니다.

fontLetterSpacingType(), setFontLetterSpacing() 및 fontLetterSpacing()도 참조하십시오 .

void QTextCharFormat::setFontOverline(bool overline)

overline 가 true인 경우, 텍스트 형식의 글꼴을 위줄이 그어진 형태로 설정하고, 그렇지 않은 경우 글꼴은 위줄이 그어지지 않은 형태로 표시됩니다.

fontOverline() 및 setFont()도 참조하십시오 .

void QTextCharFormat::setFontPointSize(qreal size)

텍스트 형식의 글꼴 size 을 설정합니다.

fontPointSize() 및 setFont()도 참조하십시오 .

void QTextCharFormat::setFontStretch(int factor)

글꼴의 늘어나기 계수를 factor 로 설정합니다.

확대 계수는 글꼴 내 모든 문자의 너비를 지정된 백분율만큼 변경합니다. 예를 들어, factor 를 150으로 설정하면 글꼴 내 모든 문자의 너비가 1.5배(즉, 150%) 넓어집니다. 기본 스트레치 계수는 100입니다. 최소 스트레치 계수는 1이며, 최대 스트레치 계수는 4000입니다.

스트레치 계수는 아웃라인 폰트에만 적용됩니다. 비트맵 폰트의 경우 스트레치 계수는 무시됩니다.

fontStretch()도 참조하십시오 .

void QTextCharFormat::setFontStrikeOut(bool strikeOut)

strikeOut 가 true인 경우, 텍스트 서식의 글꼴을 취소선(가로줄이 그어진 형태)이 적용된 상태로 설정하고, 그렇지 않은 경우 취소선 없이 표시합니다.

fontStrikeOut() 및 setFont()도 참조하십시오 .

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

hint 및 strategy 의 글꼴 스타일을 설정합니다.

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

fontStyleHint(), setFont() 및 QFont::setStyleHint()도 참조하십시오 .

void QTextCharFormat::setFontStyleName(const QString &styleName)

텍스트 형식의 글꼴을 설정합니다. styleName.

fontStyleName(), setFont() 및 QFont::setStyleName()도 참조하십시오 .

void QTextCharFormat::setFontStyleStrategy(QFont::StyleStrategy strategy)

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

fontStyleStrategy(), setFont() 및 QFont::setStyleStrategy()도 참조하십시오 .

void QTextCharFormat::setFontUnderline(bool underline)

underline 가 true인 경우, 텍스트 서식의 글꼴에 밑줄이 표시되도록 설정하며, 그렇지 않은 경우 밑줄 없이 표시됩니다.

fontUnderline() 및 setFont()도 참조하십시오 .

[since 6.11] void QTextCharFormat::setFontVariableAxes(const QMap<QFont::Tag, float> &fontVariableAxes)

텍스트 형식의 글꼴 변수 axes를 ` fontVariableAxes`로 설정합니다.

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

fontVariableAxes() 및 QFont::setVariableAxis()도 참조하십시오 .

void QTextCharFormat::setFontWeight(int weight)

텍스트 형식의 글꼴 두께를 ‘ weight ’로 설정합니다.

fontWeight(), setFont(), QFont::Weight도 참조하십시오 .

void QTextCharFormat::setFontWordSpacing(qreal spacing)

이 서식의 단어 간격을 지정된 spacing 값(픽셀 단위)으로 설정합니다.

fontWordSpacing()도 참조하십시오 .

[since 6.0] void QTextCharFormat::setSubScriptBaseline(qreal baseline)

아하스( baseline)에서 아하스의 기준선을 글꼴 높이의 백분율로 설정합니다. 기본값은 16.67%(높이의 1/6)입니다.

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

subScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset(), baselineOffset()도 참조하십시오 .

[since 6.0] void QTextCharFormat::setSuperScriptBaseline(qreal baseline)

baseline 에서 위첨자의 기준선을 글꼴 높이의 백분율(%)로 설정합니다. 기본값은 50%(높이의 1/2)입니다.

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

superScriptBaseline(), setSubScriptBaseline(), subScriptBaseline(), setBaselineOffset() 및 baselineOffset()도 참조하십시오 .

void QTextCharFormat::setTextOutline(const QPen &pen)

문자의 윤곽선을 그리는 데 사용되는 펜을 지정된 pen 로 설정합니다.

textOutline()도 참조하십시오 .

void QTextCharFormat::setToolTip(const QString &text)

지정된 text 를 텍스트 조각의 툴팁으로 설정합니다.

toolTip()도 참조하십시오 .

void QTextCharFormat::setUnderlineColor(const QColor &color)

이 서식을 가진 문자에 밑줄, 위줄 및 취소선을 그릴 때 사용되는 색상을 지정된 color 로 설정합니다.

underlineColor()도 참조하십시오 .

void QTextCharFormat::setUnderlineStyle(QTextCharFormat::UnderlineStyle style)

텍스트 밑줄 스타일을 style 로 설정합니다.

underlineStyle()도 참조하십시오 .

void QTextCharFormat::setVerticalAlignment(QTextCharFormat::VerticalAlignment alignment)

이 형식을 가진 문자에 적용되는 세로 정렬 방식을 지정된 alignment 로 설정합니다.

verticalAlignment()도 참조하십시오 .

[since 6.0] qreal QTextCharFormat::subScriptBaseline() const

인덱스의 기준선을 글꼴 높이의 백분율(%)로 반환합니다.

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

setSubScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset() 및 baselineOffset()도 참조하십시오 .

[since 6.0] qreal QTextCharFormat::superScriptBaseline() const

상첨자의 기준선을 글꼴 높이의 백분율(%)로 반환합니다.

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

setSuperScriptBaseline(), setSubScriptBaseline(), subScriptBaseline(), setBaselineOffset(), baselineOffset()도 참조하십시오 .

QPen QTextCharFormat::textOutline() const

이 형식으로 문자 윤곽선을 그리는 데 사용된 펜을 반환합니다.

setTextOutline()도 참조하십시오 .

QString QTextCharFormat::toolTip() const

특정 텍스트 조각에 대해 표시되는 툴팁을 반환합니다.

setToolTip()도 참조하십시오 .

QColor QTextCharFormat::underlineColor() const

이 형식을 가진 문자에 밑줄, 위줄 및 취소선을 그리는 데 사용되는 색상을 반환합니다.

setUnderlineColor()도 참조하십시오 .

QTextCharFormat::UnderlineStyle QTextCharFormat::underlineStyle() const

텍스트에 밑줄을 그리는 스타일을 반환합니다.

setUnderlineStyle()도 참조하십시오 .

QTextCharFormat::VerticalAlignment QTextCharFormat::verticalAlignment() const

이 형식을 가진 문자에 사용되는 수직 정렬을 반환합니다.

setVerticalAlignment()도 참조하십시오 .