QGlyphRun Class

Dokumentation der Mitgliedsfunktionen

QGlyphRun::QGlyphRun()

Konstruiert ein leeres QGlyphRun-Objekt.

QGlyphRun::QGlyphRun(const QGlyphRun &other)

Konstruiert ein QGlyphRun-Objekt, das eine Kopie von other ist.

[noexcept] QGlyphRun::~QGlyphRun()

Zerstört die QGlyphRun.

QRectF QGlyphRun::boundingRect() const

Gibt das kleinste Rechteck zurück, das alle Glyphen in diesem QGlyphRun enthält. Wenn mit setBoundingRect() ein Begrenzungsrechteck festgelegt wurde, wird dieses zurückgegeben. Andernfalls wird das Begrenzungsrechteck auf der Grundlage der Schriftmetrik der Glyphen im Glyphenlauf berechnet.

Siehe auch setBoundingRect().

void QGlyphRun::clear()

Löscht alle Daten im Objekt QGlyphRun.

QGlyphRun::GlyphRunFlags QGlyphRun::flags() const

Gibt die für diese QGlyphRun gesetzten Flags zurück.

Siehe auch setFlags(), setFlag(), und setFlag().

QList<quint32> QGlyphRun::glyphIndexes() const

Gibt die Glyphenindizes für dieses QGlyphRun Objekt zurück.

Siehe auch setGlyphIndexes() und setPositions().

bool QGlyphRun::isEmpty() const

Gibt true zurück, wenn die Seite QGlyphRun keine Glyphen enthält.

bool QGlyphRun::isRightToLeft() const

Gibt true zurück, wenn diese QGlyphRun Glyphen enthält, die von rechts nach links gemalt werden.

Siehe auch setRightToLeft() und flags().

bool QGlyphRun::overline() const

Gibt true zurück, wenn diese QGlyphRun mit einer Overline-Dekoration gezeichnet werden soll.

Siehe auch setOverline() und flags().

QList<QPointF> QGlyphRun::positions() const

Gibt die Position des Randes der Grundlinie für jede Glyphe in dieser Gruppe von Glyphenindizes zurück.

Siehe auch setPositions().

QRawFont QGlyphRun::rawFont() const

Gibt die für dieses QGlyphRun Objekt ausgewählte Schriftart zurück.

Siehe auch setRawFont().

void QGlyphRun::setBoundingRect(const QRectF &boundingRect)

Setzt das Begrenzungsrechteck der Glyphen in diesem QGlyphRun auf boundingRect. Dieses Rechteck wird von boundingRect() zurückgegeben, es sei denn, es ist null. In diesem Fall wird stattdessen das Begrenzungsrechteck der Glyphen im Glyphenlauf zurückgegeben.

Um einen solchen Fall zu unterstützen (ein Beispiel sind Markierungen, die mit einer anderen Farbe als die Haupttextfarbe gezeichnet werden sollen), ist es notwendig, den Malmechanismus auf das von boundingRect() zurückgegebene Rechteck zu beschränken, um das Zeichnen der gesamten Ligaturglyphe zu vermeiden.

Siehe auch boundingRect().

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

Wenn enabled wahr ist, ist flag aktiviert; andernfalls ist es deaktiviert.

Siehe auch flags() und setFlags().

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

Setzt die Flags dieses QGlyphRun auf flags.

Siehe auch setFlag() und flags().

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

Setzt die Glyphenindizes für dieses QGlyphRun Objekt auf glyphIndexes. Die Glyphenindizes müssen für die ausgewählte Schriftart gültig sein.

Siehe auch glyphIndexes().

void QGlyphRun::setOverline(bool overline)

Gibt an, dass QGlyphRun mit einer Überstrichdekoration gezeichnet werden soll, wenn overline wahr ist. Andernfalls sollte die QGlyphRun ohne Überstreichungsdekoration gezeichnet werden.

Siehe auch overline(), setFlag(), und setFlags().

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

Setzt die Positionen der Kante der Grundlinie für jede Glyphe in dieser Gruppe von Glyphenindizes auf positions.

Siehe auch positions().

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

Legt die Glyphenindizes und -positionen dieses QGlyphRun so fest, dass die ersten size Elemente in den Arrays glyphIndexArray und glyphPositionArray verwendet werden. Die Daten werden nicht kopiert. Der Aufrufer muss sicherstellen, dass die Arrays nicht gelöscht werden, solange diese QGlyphRun und alle Kopien davon existieren.

Siehe auch setGlyphIndexes() und setPositions().

void QGlyphRun::setRawFont(const QRawFont &rawFont)

Setzt die Schriftart, in der die Glyphenindizes nachgeschlagen werden sollen, auf die angegebene rawFont.

Siehe auch rawFont() und setGlyphIndexes().

void QGlyphRun::setRightToLeft(bool rightToLeft)

Zeigt an, dass diese QGlyphRun Glyphen enthält, die von rechts nach links angeordnet werden sollen, wenn rightToLeft wahr ist. Andernfalls wird angenommen, dass die Reihenfolge der Glyphen von links nach rechts ist.

Siehe auch isRightToLeft(), setFlag(), und setFlags().

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

Setzt die Zeichenkette, die dem Glyphenlauf entspricht, auf sourceString. Wenn gesetzt, sollten die von stringIndexes() zurückgegebenen Indizes Indizes in dieser Zeichenkette sein.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch sourceString() und stringIndexes().

void QGlyphRun::setStrikeOut(bool strikeOut)

Gibt an, dass QGlyphRun mit einer durchgestrichenen Dekoration versehen werden soll, wenn strikeOut wahr ist. Andernfalls sollte QGlyphRun ohne durchgestrichene Dekoration gemalt werden.

Siehe auch strikeOut(), setFlag(), und setFlags().

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

Setzt die Liste der String-Indizes, die den Glyphen-Indizes entsprechen, auf stringIndexes

Siehe stringIndexes() für weitere Details über die Konventionen dieser Liste.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch stringIndexes() und sourceString().

void QGlyphRun::setUnderline(bool underline)

Gibt an, dass QGlyphRun mit einer Unterstreichungsdekoration gezeichnet werden soll, wenn underline wahr ist. Andernfalls sollte QGlyphRun ohne Unterstreichungsdekoration gezeichnet werden.

Siehe auch underline(), setFlag(), und setFlags().

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

Gibt die Zeichenkette zurück, die dem Glyphenlauf entspricht, wenn der Glyphenlauf aus einer Zeichenkette erstellt wurde und die Zeichenkette vom Layout angefordert wurde.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch setSourceString(), stringIndexes(), und QTextLayout::glyphRuns().

bool QGlyphRun::strikeOut() const

Gibt true zurück, wenn diese QGlyphRun mit einer durchgestrichenen Dekoration versehen werden soll.

Siehe auch setStrikeOut() und flags().

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

Gibt die String-Indizes zurück, die jedem Glyphenindex entsprechen, wenn der Glyphenlauf aus einem String konstruiert wurde und String-Indizes vom Layout angefordert wurden. In diesem Fall entspricht die Länge des zurückgegebenen Vektors der Länge von glyphIndexes(). In anderen Fällen ist er leer.

Da eine einzelne Glyphe mehreren Zeichen in der Quellzeichenkette entsprechen kann, kann es Lücken in der Liste der Zeichenfolgenindizes geben. Wenn beispielsweise die Zeichenkette "first" von einer Schriftart verarbeitet wird, die eine Ligatur für das Zeichenpaar "fi" enthält, dann wird die fünf Zeichen lange Zeichenkette einen Glyphenlauf erzeugen, der nur aus vier Glyphen besteht. Die Glyphenindizes können in diesem Fall (1, 2, 3, 4) sein (vier beliebige Glyphenindizes), während die Zeichenfolgenindizes (0, 2, 3, 4) lauten würden. Die Glyphen befinden sich in der logischen Reihenfolge der Zeichenkette, d. h., die erste Glyphe umfasst in diesem Fall die Zeichen 0 und 1.

Umgekehrt kann ein einzelnes Zeichen auch mehrere Glyphen erzeugen; in diesem Fall gibt es doppelte Einträge in der Liste der Zeichenfolgenindizes.

Die String-Indizes entsprechen dem String, der optional über sourceString() verfügbar ist.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch setStringIndexes(), sourceString(), und QTextLayout::glyphRuns().

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

Tauscht diese Glyph-Run-Instanz mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

bool QGlyphRun::underline() const

Gibt true zurück, wenn diese QGlyphRun mit einer Unterstreichungsdekoration versehen werden soll.

Siehe auch setUnderline() und flags().

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

Vergleicht other mit diesem QGlyphRun Objekt. Gibt true zurück, wenn die Liste der Glyphenindizes, die Liste der Positionen oder die Schriftart unterschiedlich sind, ansonsten false.

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

Weist other diesem QGlyphRun Objekt zu.

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

Vergleicht other mit diesem QGlyphRun Objekt. Gibt true zurück, wenn die Liste der Glyphenindizes, die Liste der Positionen und die Schriftart alle gleich sind, andernfalls false.