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() およびsetFlag()も参照 。

QList<quint32> QGlyphRun::glyphIndexes() const

このQGlyphRun オブジェクトのグリフインデックスを返す。

setGlyphIndexes() およびsetPositions()も参照 。

bool QGlyphRun::isEmpty() const

QGlyphRun にグ リ フ が 1 つ も ない と き は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 に設定 し ます。この矩形は、それが null でない限り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)

rightToLeft が true の と き は、 こ のQGlyphRun がグリフを右から左へ並べる必要があ る こ と を示す。そうでない場合はグリフの順序は左から右とみなされる。

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 が true の場合、この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 を返します。