QTextCharFormat 类

成员函数文档

QTextCharFormat::QTextCharFormat()

构造一个新的字符格式对象。

QString QTextCharFormat::anchorHref() const

返回文本格式的超文本链接，如果没有设置，则返回空字符串。

请参阅setAnchorHref。

QStringList QTextCharFormat::anchorNames() const

返回与文本格式关联的锚点名称，如果没有设置，则返回空字符串列表。如果设置了锚点名称，则具有此格式的文本可以是超文本链接的目标。

请参阅setAnchorNames。

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

返回基线偏移量，单位为百分比。

此函数是在 Qt 6.0 中引入的。

请参阅setBaselineOffset，setSubScriptBaseline，subScriptBaseline，setSuperScriptBaseline 和 superScriptBaseline。

QFont QTextCharFormat::font() const

返回该字符格式的字体。

另请参阅 setFont。

QFont::Capitalization QTextCharFormat::fontCapitalization() const

返回当前字体的首字母大写类型。

请参阅setFontCapitalization。

QVariant QTextCharFormat::fontFamilies() const

返回文本格式的字体家族。

请参阅setFontFamilies 和 font。

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()。

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)

设置文本的基线（相对于高度的百分比）。正值会使文本向上移动相应的百分比；负值会使文本向下移动。默认值为0。

此函数是在 Qt 6.0 中引入的。

另请参阅 baselineOffset()，setSubScriptBaseline()，subScriptBaseline()，setSuperScriptBaseline()和superScriptBaseline()。

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

设置文本格式的字体。

如果behavior是QTextCharFormat::FontPropertiesAll，则未显式设置的字体属性被视为已使用默认值设置；如果behavior是QTextCharFormat::FontPropertiesSpecifiedOnly，则未显式设置的字体属性将忽略，并保留相应的属性值不变。

另请参阅 font()。

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

将此字体中出现的文本的首字母标识设置为指定值。

字体的首字母标识使文本以选定的首字母识别模式显示。

另请参阅 fontCapitalization()。

void QTextCharFormat::setFontFamilies(const QStringList &families)

设置文本格式的字体族。

另请参阅 fontFamilies()和setFont()。

void QTextCharFormat::setFontFixedPitch(bool fixedPitch)

如果fixedPitch为true，则将文本格式的字体设置为固定间距；否则使用非固定间距字体。

另请参阅 fontFixedPitch()和setFont()。

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

将文本格式的字体的光栅提示偏好设置为指定值。

另请参阅 fontHintingPreference()，setFont()和QFont::setHintingPreference()。

void QTextCharFormat::setFontItalic(bool italic)

如果italic为true，则将文本格式的字体设置为斜体；否则字体将非斜体。

另请参阅 fontItalic()和setFont()。

void QTextCharFormat::setFontKerning(bool enable)

如果enable为true，则为该字体启用字距调整；否则禁用。

启用字距调整后，即使是拉丁文字，字体计量也不再相加。换句话说，'a'的宽度加上'b'的宽度不一定是"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)

设置字体样式 策略。

另请参阅 fontStyleStrategy，setFont，以及 QFont::setStyleStrategy。

void QTextCharFormat::setFontUnderline(bool underline)

如果 underline 为 true，则将文本格式的字体设置为下划线；否则将显示为非下划线。

另请参阅 fontUnderline 以及 setFont。

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%（高度的一半）。

此函数是在 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)

设置用于绘制带有该格式的字符下划线、上划线和删除线的颜色。

另请参阅 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 中引入的。

另请参阅 setSuperScriptBaselin()), setSubScriptBaseline(), subScriptBaselinesetBaselineOffset(), 和 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().