QGlyphRun Class

Documentation des fonctions membres

QGlyphRun::QGlyphRun()

Crée un objet QGlyphRun vide.

QGlyphRun::QGlyphRun(const QGlyphRun &other)

Crée un objet `QGlyphRun` qui est une copie de ` other`.

[noexcept] QGlyphRun::~QGlyphRun()

Supprime l'QGlyphRun.

QRectF QGlyphRun::boundingRect() const

Renvoie le plus petit rectangle contenant tous les glyphes de cette séquence de glyphes ( QGlyphRun). Si un rectangle de délimitation a été défini à l'aide de la fonction setBoundingRect(), c'est celui-ci qui sera renvoyé. Sinon, le rectangle de délimitation sera calculé à partir des métriques des glyphes de la séquence.

Voir également setBoundingRect().

void QGlyphRun::clear()

Efface toutes les données de l'objet « QGlyphRun ».

QGlyphRun::GlyphRunFlags QGlyphRun::flags() const

Renvoie les indicateurs activés pour cet QGlyphRun.

Voir également setFlags() et setFlag().

QList<quint32> QGlyphRun::glyphIndexes() const

Renvoie les index des glyphes associés à cet objet ` QGlyphRun `.

Voir également setGlyphIndexes() et setPositions().

bool QGlyphRun::isEmpty() const

Renvoie « true » si l'QGlyphRun e ne contient aucun glyphe.

bool QGlyphRun::isRightToLeft() const

Renvoie « true » si cet QGlyphRun contient des glyphes dessinés de droite à gauche.

Voir également setRightToLeft() et flags().

bool QGlyphRun::overline() const

Renvoie ` true ` si cet ` QGlyphRun ` doit être affiché avec une ligne supérieure.

Voir également setOverline() et flags().

QList<QPointF> QGlyphRun::positions() const

Renvoie la position du bord de la ligne de base pour chaque glyphe de cet ensemble d'index de glyphes.

Voir également setPositions().

QRawFont QGlyphRun::rawFont() const

Renvoie la police sélectionnée pour cet objet « QGlyphRun ».

Voir aussi setRawFont().

void QGlyphRun::setBoundingRect(const QRectF &boundingRect)

Définit le rectangle englobant des glyphes de cette « QGlyphRun » sur boundingRect. Ce rectangle sera renvoyé par la fonction boundingRect() à moins qu’il ne soit nul, auquel cas c’est le rectangle englobant des glyphes de la « glyph run » qui sera renvoyé à la place.

Afin de prendre en charge un tel cas (par exemple, des sélections qui doivent être dessinées dans une couleur différente de celle du texte principal), il est nécessaire de limiter le mécanisme de dessin au rectangle renvoyé par la fonction ` boundingRect()` afin d’éviter de dessiner l’intégralité du glyphe de ligature.

Voir également boundingRect().

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

Si la valeur de enabled est « true », alors flag est activé ; dans le cas contraire, il est désactivé.

Voir aussi flags() et setFlags().

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

Définit les indicateurs de cette QGlyphRun sur flags.

Voir également setFlag() et flags().

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

Définissez les indices de glyphes de cet objet « QGlyphRun » sur glyphIndexes. Les indices de glyphes doivent être valides pour la police sélectionnée.

Voir aussi glyphIndexes().

void QGlyphRun::setOverline(bool overline)

Indique que cet élément QGlyphRun doit être affiché avec une ligne supérieure si la condition overline est vraie. Dans le cas contraire, l'élément QGlyphRun doit être affiché sans ligne supérieure.

Voir également overline(), setFlag() et setFlags().

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

Définit les positions du bord de la ligne de base de chaque glyphe de cet ensemble d'index de glyphes sur positions.

Voir également positions().

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

Définit les index et les positions des glyphes de cet objet ` QGlyphRun ` afin d’utiliser les premiers éléments ` size ` des tableaux ` glyphIndexArray ` et ` glyphPositionArray`. Les données ne sont pas copiées. L’appelant doit garantir que les tableaux ne seront pas supprimés tant que cet objet ` QGlyphRun ` et toutes ses copies existeront.

Voir également setGlyphIndexes() et setPositions().

void QGlyphRun::setRawFont(const QRawFont &rawFont)

Définit la police à utiliser pour rechercher les index de glyphes sur l'rawFont spécifié.

Voir également rawFont() et setGlyphIndexes().

void QGlyphRun::setRightToLeft(bool rightToLeft)

Indique que cette QGlyphRun contient des glyphes qui doivent être classés de droite à gauche si la valeur de rightToLeft est « true ». Dans le cas contraire, l’ordre des glyphes est supposé être de gauche à droite.

Voir également isRightToLeft(), setFlag() et setFlags().

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

Définissez la chaîne correspondant à la séquence de glyphes sur sourceString. Si cette option est activée, les index renvoyés par stringIndexes() doivent correspondre à des index de cette chaîne.

Cette fonction a été introduite dans Qt 6.5.

Voir également sourceString() et stringIndexes().

void QGlyphRun::setStrikeOut(bool strikeOut)

Indique que cet élément QGlyphRun doit être affiché avec un effet de biffure si strikeOut est vrai. Dans le cas contraire, l'élément QGlyphRun doit être affiché sans effet de biffure.

Voir également strikeOut(), setFlag() et setFlags().

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

Définit la liste des index de chaînes correspondant aux index de glyphes sur stringIndexes

Voir stringIndexes() pour plus de détails sur les conventions relatives à cette liste.

Cette fonction a été introduite dans Qt 6.5.

Voir également stringIndexes() et sourceString().

void QGlyphRun::setUnderline(bool underline)

Indique que cet élément QGlyphRun doit être affiché avec un soulignement si la valeur de underline est « true ». Dans le cas contraire, l'élément QGlyphRun doit être affiché sans soulignement.

Voir également ` underline()`, ` setFlag()` et ` setFlags()`.

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

Renvoie la chaîne correspondant à la séquence de glyphes, si celle-ci a été créée à partir d'une chaîne et que cette chaîne a été demandée par la mise en page.

Cette fonction a été introduite dans Qt 6.5.

Voir également setSourceString(), stringIndexes() et QTextLayout::glyphRuns().

bool QGlyphRun::strikeOut() const

Renvoie « true » si cet QGlyphRun doit être affiché avec un effet de barré.

Voir également setStrikeOut() et flags().

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

Renvoie les indices de chaîne correspondant à chaque indice de glyphe, si la séquence de glyphes a été construite à partir d’une chaîne et que les indices de chaîne ont été demandés à la mise en page. Dans ce cas, la longueur du vecteur renvoyé correspondra à la longueur de ` glyphIndexes()`. Dans les autres cas, il sera vide.

Étant donné qu’un seul glyphe peut correspondre à plusieurs caractères de la chaîne source, il peut y avoir des lacunes dans la liste des indices de chaîne. Par exemple, si la chaîne « first » est traitée par une police contenant une ligature pour la paire de caractères « fi », alors cette chaîne de cinq caractères générera une séquence de glyphes composée de seulement quatre glyphes. Dans ce cas, les indices de glyphes peuvent alors être (1, 2, 3, 4) (quatre indices de glyphes arbitraires), tandis que les indices de chaîne seraient (0, 2, 3, 4). Les glyphes suivent l’ordre logique de la chaîne ; il en découle donc que, dans ce cas, le premier glyphe couvre les caractères 0 et 1.

À l’inverse, un seul caractère peut également générer plusieurs glyphes, auquel cas il y aura des entrées en double dans la liste des indices de chaîne.

Les indices de chaîne correspondent à la chaîne, accessible de manière facultative via ` sourceString()`.

Cette fonction a été introduite dans Qt 6.5.

Voir également setStringIndexes(), sourceString() et QTextLayout::glyphRuns().

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

Permet d'échanger cette instance de série de glyphes contre celle de other. Cette opération est très rapide et ne rencontre jamais d'échec.

bool QGlyphRun::underline() const

Renvoie « true » si cet élément « QGlyphRun » doit être affiché avec un soulignement.

Voir également setUnderline() et flags().

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

Compare l'objet ` other ` à cet objet ` QGlyphRun `. Renvoie ` true ` si l'un des éléments de la liste des index de glyphes, de la liste des positions ou de la police est différent ; sinon, renvoie ` false`.

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

Attribue l'other à cet objet QGlyphRun.

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

Compare other à cet objet QGlyphRun. Renvoie true si la liste des indices de glyphes, la liste des positions et la police sont toutes identiques ; sinon, renvoie false.