QGlyphRun Class

Documentation des fonctions membres

QGlyphRun::QGlyphRun()

Construit un objet QGlyphRun vide.

QGlyphRun::QGlyphRun(const QGlyphRun &other)

Construit un objet QGlyphRun qui est une copie de other.

[noexcept] QGlyphRun::~QGlyphRun()

Détruit le site QGlyphRun.

QRectF QGlyphRun::boundingRect() const

Renvoie le plus petit rectangle contenant tous les glyphes de ce site QGlyphRun. Si un rectangle de délimitation a été défini à l'aide de setBoundingRect(), il sera renvoyé. Sinon, le rectangle de délimitation sera calculé sur la base des métriques de police des glyphes dans le parcours des glyphes.

Voir aussi setBoundingRect().

void QGlyphRun::clear()

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

QGlyphRun::GlyphRunFlags QGlyphRun::flags() const

Renvoie les drapeaux définis pour cette QGlyphRun.

Voir aussi setFlags() et setFlag().

QList<quint32> QGlyphRun::glyphIndexes() const

Renvoie les index des glyphes pour cet objet QGlyphRun.

Voir aussi setGlyphIndexes() et setPositions().

bool QGlyphRun::isEmpty() const

Renvoie true si le site QGlyphRun ne contient pas de glyphes.

bool QGlyphRun::isRightToLeft() const

Renvoie true si ce site QGlyphRun contient des glyphes qui sont peints de la droite vers la gauche.

Voir aussi setRightToLeft() et flags().

bool QGlyphRun::overline() const

Renvoie true si ce QGlyphRun doit être peint avec une décoration en surlignage.

Voir aussi setOverline() et flags().

QList<QPointF> QGlyphRun::positions() const

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

Voir aussi 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 de délimitation des glyphes de cette QGlyphRun comme étant boundingRect. Ce rectangle sera renvoyé par boundingRect() à moins qu'il ne soit nul, auquel cas le rectangle de délimitation des glyphes du parcours de glyphes sera renvoyé à la place.

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

Voir aussi boundingRect().

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

Si enabled est vrai, flag est activé ; sinon, il est désactivé.

Voir aussi flags() et setFlags().

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

Définit les drapeaux de ce QGlyphRun à flags.

Voir aussi setFlag() et flags().

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

Définit les index de glyphes de cet objet QGlyphRun à glyphIndexes. Les index de glyphes doivent être valides pour la police sélectionnée.

Voir aussi glyphIndexes().

void QGlyphRun::setOverline(bool overline)

Indique que cette page QGlyphRun doit être peinte avec une décoration surlignée si overline est vrai. Dans le cas contraire, la page QGlyphRun doit être peinte sans décoration de surlignage.

Voir aussi overline(), setFlag() et setFlags().

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

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

Voir aussi positions().

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

Définit les index et les positions des glyphes de ce site QGlyphRun afin d'utiliser les premiers éléments de size dans les tableaux glyphIndexArray et glyphPositionArray. Les données ne sont pas copiées. L'appelant doit garantir que les tableaux ne sont pas supprimés tant que ce QGlyphRun et ses copies existent.

Voir également setGlyphIndexes() et setPositions().

void QGlyphRun::setRawFont(const QRawFont &rawFont)

Définit la police dans laquelle les index des glyphes doivent être recherchés à l'adresse rawFont spécifiée.

Voir aussi rawFont() et setGlyphIndexes().

void QGlyphRun::setRightToLeft(bool rightToLeft)

Indique que ce site QGlyphRun contient des glyphes qui doivent être ordonnés de droite à gauche si rightToLeft est vrai. Sinon, l'ordre des glyphes est supposé être de gauche à droite.

Voir aussi isRightToLeft(), setFlag() et setFlags().

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

Définit la chaîne correspondant au glyphe exécuté à sourceString. Si elle est définie, les index renvoyés par stringIndexes() doivent être des index dans cette chaîne.

Cette fonction a été introduite dans Qt 6.5.

Voir aussi sourceString() et stringIndexes().

void QGlyphRun::setStrikeOut(bool strikeOut)

Indique que cette page QGlyphRun doit être peinte avec une décoration barrée si strikeOut est vrai. Dans le cas contraire, la page QGlyphRun doit être peinte sans décoration en relief.

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 de caractères correspondant aux index de glyphes à stringIndexes

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

Cette fonction a été introduite dans Qt 6.5.

Voir aussi stringIndexes() et sourceString().

void QGlyphRun::setUnderline(bool underline)

Indique que cette page QGlyphRun doit être peinte avec une décoration soulignée si underline est vrai. Dans le cas contraire, la page QGlyphRun doit être peinte sans décoration soulignée.

Voir aussi underline(), setFlag() et setFlags().

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

Renvoie la chaîne correspondant au parcours de glyphes, si le parcours de glyphes a été créé à partir d'une chaîne et si la chaîne a été demandée à la disposition.

Cette fonction a été introduite dans Qt 6.5.

Voir aussi setSourceString(), stringIndexes(), et QTextLayout::glyphRuns().

bool QGlyphRun::strikeOut() const

Renvoie true si cette page QGlyphRun doit être peinte avec une décoration barrée.

Voir aussi setStrikeOut() et flags().

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

Renvoie les index de chaîne correspondant à chaque index de glyphe, si le parcours des glyphes a été construit à partir d'une chaîne et que des index de chaîne ont été demandés à la disposition. Dans ce cas, la longueur du vecteur retourné correspondra à la longueur de glyphIndexes(). Dans les autres cas, il sera vide.

Étant donné qu'un seul glyphe peut correspondre à plusieurs caractères dans la chaîne source, il peut y avoir des lacunes dans la liste des index de chaîne. Par exemple, si la chaîne "first" est traitée par une police qui contient une ligature pour la paire de caractères "fi", la chaîne de cinq caractères générera une série de glyphes composée de seulement quatre glyphes. Dans ce cas, les index des glyphes peuvent être (1, 2, 3, 4) (quatre index de glyphes arbitraires), tandis que les index des chaînes de caractères seraient (0, 2, 3, 4). Les glyphes sont dans l'ordre logique de la chaîne, ce qui implique que le premier glyphe couvre les caractères 0 et 1 dans ce cas.

Inversement, 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 index de chaîne.

Les index de chaîne correspondent à la chaîne, optionnellement disponible via sourceString().

Cette fonction a été introduite dans Qt 6.5.

Voir aussi setStringIndexes(), sourceString(), et QTextLayout::glyphRuns().

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

Remplace cette instance d'exécution de glyphe par other. Cette opération est très rapide et n'échoue jamais.

bool QGlyphRun::underline() const

Renvoie true si ce QGlyphRun doit être peint avec une décoration soulignée.

Voir aussi setUnderline() et flags().

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

Compare other à cet objet QGlyphRun. Renvoie true si la liste des index de glyphes, la liste des positions ou la police sont différentes, sinon renvoie false.

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

Attribue other à cet objet QGlyphRun.

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

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