QGlyphRun Class

メンバ関数のドキュメント

QGlyphRun::QGlyphRun()

空の QGlyphRun オブジェクトを作成します。

QGlyphRun::QGlyphRun(const QGlyphRun &other)

other のコピーであるQGlyphRunオブジェクトを作成します。

[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()によって返されます。ただし、この値がnullの場合は、代わりにグリフ・ラン内のグリフの境界矩形が返されます。

このようなケース（例：本文の色とは異なる色で描画されるべき選択範囲など）に対応するためには、リガチュア・グリフ全体が描画されないように、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 がtrueの場合、右から左の順序で並べるべきグリフが含まれていることを示します。それ以外の場合は、グリフの順序は左から右であるとみなされます。

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 がtrueの場合、この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() の長さと同じになります。それ以外の場合は、空になります。

1つのグリフがソース文字列内の複数の文字に対応する場合があるため、文字列インデックスのリストには隙間が生じる可能性があります。例えば、文字列「first」が、文字ペア「fi」の合字を含むフォントによって処理された場合、この5文字の文字列は4つのグリフのみで構成されるグリフランを生成します。 この場合、グリフインデックスは (1, 2, 3, 4) （4つの任意のグリフインデックス）となる可能性がありますが、文字列インデックスは (0, 2, 3, 4) となります。 グリフは文字列の論理的な順序で並んでいるため、このケースでは最初のグリフが文字 0 と 1 にまたがっていることが暗黙的に示されます。

逆に、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)

このQGlyphRun オブジェクトにother を割り当てます。

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

other と、このQGlyphRun オブジェクトを比較します。グリフインデックスのリスト、位置のリスト、およびフォントがすべて等しい場合はtrue を返し、そうでない場合はfalse を返します。