QGlyphRun Class

成员函数文档

QGlyphRun::QGlyphRun()

创建一个空的 QGlyphRun 对象。

QGlyphRun::QGlyphRun(const QGlyphRun &other)

创建一个 QGlyphRun 对象，该对象是other 的副本。

[noexcept] QGlyphRun::~QGlyphRun()

销毁QGlyphRun 。

QRectF QGlyphRun::boundingRect() const

返回包含该QGlyphRun 中所有字形的最小的矩形。如果已通过setBoundingRect()设置了边界矩形，则返回该边界矩形。否则，将根据字形序列中各字形的字体度量值计算边界矩形。

另请参阅 setBoundingRect()。

void QGlyphRun::clear()

清除QGlyphRun 对象中的所有数据。

QGlyphRun::GlyphRunFlags QGlyphRun::flags() const

返回为该QGlyphRun 设置的标志。

另请参阅 setFlags() 和setFlag()。

QList<quint32> QGlyphRun::glyphIndexes() const

返回此QGlyphRun 对象的字形索引。

另请参阅 setGlyphIndexes() 和setPositions()。

bool QGlyphRun::isEmpty() const

如果QGlyphRun 不包含任何字形，则返回true 。

bool QGlyphRun::isRightToLeft() const

如果该QGlyphRun 包含从右向左绘制的字形，则返回true 。

另请参阅 setRightToLeft() 和flags()。

bool QGlyphRun::overline() const

如果该QGlyphRun 应绘制带上划线的装饰，则返回true 。

另请参阅 setOverline() 和flags()。

QList<QPointF> QGlyphRun::positions() const

返回该字形索引集中的每个字形的基线边缘位置。

另请参阅 setPositions()。

QRawFont QGlyphRun::rawFont() const

返回为此QGlyphRun 对象选定的字体。

另请参阅 setRawFont()。

void QGlyphRun::setBoundingRect(const QRectF &boundingRect)

将此QGlyphRun 中字形的边界矩形设置为boundingRect 。boundingRect() 函数将返回该矩形，除非该参数为空；若为空，则返回字形序列中字形的边界矩形。

为了支持此类情况（例如，应使用与正文颜色不同的颜色绘制选区），有必要将绘制机制裁剪为 `boundingRect()` 返回的矩形，以避免绘制整个连字字形。

另请参阅 boundingRect()。

void QGlyphRun::setFlag(QGlyphRun::GlyphRunFlag flag, bool enabled = true)

如果enabled 为 true，则flag 处于启用状态；否则，处于禁用状态。

另请参阅 flags() 和setFlags()。

void QGlyphRun::setFlags(QGlyphRun::GlyphRunFlags flags)

将此QGlyphRun 的标志设置为flags 。

另请参阅 setFlag() 和flags()。

void QGlyphRun::setGlyphIndexes(const QList<quint32> &glyphIndexes)

将此QGlyphRun 对象的字形索引设置为glyphIndexes 。字形索引必须对所选字体有效。

另请参阅 glyphIndexes()。

void QGlyphRun::setOverline(bool overline)

表示如果overline 为真，则应为该QGlyphRun 绘制上划线装饰；否则，应为QGlyphRun 绘制无上划线装饰。

另请参阅 overline()、setFlag() 和setFlags()。

void QGlyphRun::setPositions(const QList<QPointF> &positions)

将此字形索引集中的每个字形的基线边缘位置设置为positions 。

另请参阅 positions()。

void QGlyphRun::setRawData(const quint32 *glyphIndexArray, const QPointF *glyphPositionArray, int size)

设置此QGlyphRun 的字形索引和位置，以使用数组glyphIndexArray 和glyphPositionArray 中的前size 个元素。数据不会被复制。调用方必须保证，只要此QGlyphRun 及其任何副本存在，这些数组就不会被删除。

另请参阅 setGlyphIndexes() 和setPositions()。

void QGlyphRun::setRawFont(const QRawFont &rawFont)

将用于查找字形索引的字体设置为指定的rawFont 。

另请参阅 rawFont() 和setGlyphIndexes()。

void QGlyphRun::setRightToLeft(bool rightToLeft)

表示该QGlyphRun 包含的字形，如果rightToLeft 为真，则应按从右到左的顺序排列。否则，字形的顺序默认为从左到右。

另请参阅 isRightToLeft()、setFlag() 和setFlags()。

[since 6.5] void QGlyphRun::setSourceString(const QString &sourceString)

将与字形序列对应的字符串设置为sourceString 。如果进行了此设置，则stringIndexes() 返回的索引应为该字符串中的索引。

该函数在 Qt 6.5 中引入。

另请参阅 sourceString() 和stringIndexes()。

void QGlyphRun::setStrikeOut(bool strikeOut)

表示如果strikeOut 为真，则应为该QGlyphRun 添加删除线装饰。否则，应为该QGlyphRun 绘制无删除线装饰。

另请参阅 strikeOut()、setFlag() 和setFlags()。

[since 6.5] void QGlyphRun::setStringIndexes(const QList<qsizetype> &stringIndexes)

将与字形索引对应的字符串索引列表设置为stringIndexes

有关此列表约定规则的更多详细信息，请参阅stringIndexes()。

该函数于 Qt 6.5 中引入。

另请参阅 stringIndexes() 和sourceString()。

void QGlyphRun::setUnderline(bool underline)

表示如果underline 为真，则应为该QGlyphRun 绘制带下划线的样式。否则，应为该QGlyphRun 绘制不带下划线的样式。

另请参阅 underline()、setFlag() 和setFlags()。

[since 6.5] QString QGlyphRun::sourceString() const

如果字形序列是从字符串创建的，且该字符串是从布局中请求的，则返回与该字形序列对应的字符串。

该函数自 Qt 6.5 起引入。

另请参阅 setSourceString()、stringIndexes() 和QTextLayout::glyphRuns()。

bool QGlyphRun::strikeOut() const

如果该QGlyphRun 应以划线样式进行绘制，则返回true 。

另请参见 setStrikeOut() 和flags()。

[since 6.5] QList<qsizetype> QGlyphRun::stringIndexes() const

如果字形序列是从字符串构建的，且已向布局请求了字符串索引，则返回与每个字形索引对应的字符串索引。在这种情况下，返回向量的长度将与glyphIndexes()的返回值长度一致。在其他情况下，该向量将为空。

由于单个字形可能对应源字符串中的多个字符，因此字符串索引列表中可能会存在间隙。例如，如果字符串“first”由包含字符对“fi”连字的字体进行处理，那么这个由五个字符组成的字符串将生成一个仅包含四个字形的字形序列。 此时，字形索引可能是 (1, 2, 3, 4)（四个任意字形索引），而字符串索引则是 (0, 2, 3, 4)。 字形遵循字符串的逻辑顺序，因此可以推断，在此情况下，第一个字形涵盖了字符 0 和 1。

反之，一个字符也可能生成多个字形，在这种情况下，字符串索引列表中将出现重复条目。

字符串索引与字符串相对应，可通过sourceString() 获取（可选）。

该函数在 Qt 6.5 中引入。

另请参阅 setStringIndexes()、sourceString() 和QTextLayout::glyphRuns()。

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

将当前符文运行实例与other 互换。此操作速度极快，且绝不会失败。

bool QGlyphRun::underline() const

如果该QGlyphRun 应采用下划线样式进行绘制，则返回true 。

另请参阅 setUnderline() 和flags()。

bool QGlyphRun::operator!=(const QGlyphRun &other) const

将other 与该QGlyphRun 对象进行比较。如果字形索引列表、位置列表或字体中的任何一项不同，则返回true ；否则返回false 。

QGlyphRun &QGlyphRun::operator=(const QGlyphRun &other)

将other 分配给此QGlyphRun 对象。

bool QGlyphRun::operator==(const QGlyphRun &other) const

将other 与该QGlyphRun 对象进行比较。如果字形索引列表、位置列表和字体均相等，则返回true ；否则返回false 。