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 にグリフがない場合は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 が true ならば、この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 が真の場合、この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)

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

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

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