QFontMetricsF Class

QFont font("times", 24);
QFontMetricsF fm(font);
qreal pixelsWide = fm.horizontalAdvance("What's the advance width of this text?");
qreal pixelsHigh = fm.height();

Documentation des fonctions membres

[explicit] QFontMetricsF::QFontMetricsF(const QFont &font)

Crée un objet de métriques de police pour font.

Les métriques de police seront compatibles avec le périphérique de dessin utilisé pour créer font.

L'objet de métriques de police contient les informations relatives à la police transmise au constructeur au moment de sa création, et n'est pas mis à jour si les attributs de la police sont modifiés ultérieurement.

Utilisez QFontMetricsF(const QFont &, QPaintDevice *) pour obtenir les métriques de police compatibles avec un périphérique de dessin donné.

QFontMetricsF::QFontMetricsF(const QFontMetrics &fontMetrics)

Crée un objet de métriques de police avec une précision en virgule flottante à partir de l'objet ` fontMetrics ` fourni.

QFontMetricsF::QFontMetricsF(const QFont &font, const QPaintDevice *paintdevice)

Crée un objet de métriques de police pour font et paintdevice.

Les métriques de police seront compatibles avec le périphérique de dessin transmis. Si l'paintdevice est nullptr, les métriques seront compatibles avec l'écran, c'est-à-dire les métriques que vous obtenez si vous utilisez la police pour dessiner du texte sur un widgets ou un pixmaps, et non sur un QPicture ou un QPrinter.

L’objet « metrics » de la police contient les informations relatives à la police transmise au constructeur au moment de sa création ; il n’est pas mis à jour si les attributs de la police sont modifiés ultérieurement.

QFontMetricsF::QFontMetricsF(const QFontMetricsF &fm)

Crée une copie de fm.

[constexpr noexcept default] QFontMetricsF::QFontMetricsF(QFontMetricsF &&)

Crée par « move » une instance de ` QFontMetricsF`.

[noexcept] QFontMetricsF::~QFontMetricsF()

Détruit l'objet de métriques de police et libère toutes les ressources allouées.

qreal QFontMetricsF::ascent() const

Renvoie la hauteur de la police.

L'ascension d'une police correspond à la distance entre la ligne de base et la position la plus haute atteinte par les caractères. Dans la pratique, certains créateurs de polices s'écartent de cette règle, par exemple lorsqu'ils ajoutent plusieurs accents au-dessus d'un caractère, ou pour s'adapter à un caractère particulier ; il est donc possible (bien que rare) que cette valeur soit trop petite.

Voir également descent().

qreal QFontMetricsF::averageCharWidth() const

Renvoie la largeur moyenne des glyphes de la police.

QRectF QFontMetricsF::boundingRect(QChar ch) const

Renvoie le rectangle englobant du caractère ch par rapport au point le plus à gauche de la ligne de base.

Notez que le rectangle de délimitation peut s'étendre à gauche de (0, 0), par exemple pour les polices en italique, et que le texte affiché peut couvrir tous les pixels du rectangle de délimitation.

Notez que le rectangle s'étend généralement à la fois au-dessus et en dessous de la ligne de base.

Voir également horizontalAdvance().

QRectF QFontMetricsF::boundingRect(const QString &text) const

Renvoie le rectangle englobant des caractères de la chaîne spécifiée par ` text`. Le rectangle englobant couvre toujours au moins l'ensemble des pixels que le texte couvrirait s'il était tracé en (0, 0).

Notez que le rectangle englobant peut s'étendre à gauche de (0, 0), par exemple pour les polices en italique, et que la largeur du rectangle renvoyé peut être différente de celle renvoyée par la méthode horizontalAdvance().

Si vous souhaitez connaître la largeur d’avance de la chaîne (pour disposer plusieurs chaînes les unes à côté des autres), utilisez plutôt la méthode ` horizontalAdvance()`.

Les caractères de nouvelle ligne sont traités comme des caractères normaux, et non comme des sauts de ligne.

La hauteur du rectangle de délimitation est au moins égale à la valeur renvoyée par ` height()`.

Voir également horizontalAdvance(), height() et QPainter::boundingRect().

[since 6.3] QRectF QFontMetricsF::boundingRect(const QString &text, const QTextOption &option) const

Renvoie le rectangle englobant des caractères de la chaîne spécifiée par ` text `, mise en page à l'aide de ` option`. Le rectangle englobant couvre toujours au moins l'ensemble des pixels que le texte couvrirait s'il était tracé en (0, 0).

Notez que le rectangle englobant peut s’étendre à gauche de (0, 0), par exemple pour les polices en italique, et que la largeur du rectangle renvoyé peut être différente de celle renvoyée par la méthode horizontalAdvance().

Si vous souhaitez connaître la largeur d'avance de la chaîne (pour disposer plusieurs chaînes les unes à côté des autres), utilisez plutôt la méthode horizontalAdvance().

Les caractères de nouvelle ligne sont traités comme des caractères normaux, et non comme des sauts de ligne.

La hauteur du rectangle de délimitation est au moins égale à la valeur renvoyée par height().

Cette fonction a été introduite dans Qt 6.3.

Voir également horizontalAdvance(), height() et QPainter::boundingRect().

QRectF QFontMetricsF::boundingRect(const QRectF &rect, int flags, const QString &text, int tabStops = 0, int *tabArray = nullptr) const

Renvoie le rectangle de délimitation des caractères contenus dans l’ text donné. Il s’agit de l’ensemble des pixels que le texte couvrirait s’il était affiché en étant contraint au rectangle de délimitation spécifié par rect. Si rect est une référence à un objet nullptr, par exemple lors du passage d’un QRectF construit par défaut, le rectangle de délimitation ne se limitera pas à cette taille.

L’argument ` flags ` correspond à la somme logique (OU) des indicateurs suivants :

• Qt::AlignLeft aligne sur le bord gauche, sauf pour l'arabe et l'hébreu où il s'aligne à droite.
• Qt::AlignRight aligne sur la marge droite, sauf pour l’arabe et l’hébreu où il s’aligne à gauche.
• Qt::AlignJustify produit un texte justifié.
• Qt::AlignHCenter aligne le texte au centre horizontalement.
• Qt::AlignTop aligne sur le bord supérieur.
• Qt::AlignBottom s'aligne sur la marge inférieure.
• Qt::AlignVCenter centré verticalement
• Qt::AlignCenter (== Qt::AlignHCenter | Qt::AlignVCenter)
• Qt::TextSingleLine ignore les caractères de saut de ligne dans le texte.
• Qt::TextExpandTabs développe les tabulations (voir ci-dessous)
• Qt::TextShowMnemonic interprète « &x » comme x; c'est-à-dire souligné.
• Qt::TextWordWrap coupe le texte pour l'adapter au rectangle.

Qt::Horizontal L'alignement par défaut est Qt::AlignLeft et l'alignement vertical par défaut est Qt::AlignTop.

Si plusieurs indicateurs d’alignement horizontal ou plusieurs indicateurs d’alignement vertical sont activés, l’alignement obtenu n’est pas défini.

Ces indicateurs sont définis dans Qt::AlignmentFlag.

Si ` Qt::TextExpandTabs ` est défini à ` flags`, le comportement suivant est utilisé pour interpréter les caractères de tabulation dans le texte :

• Si ` tabArray ` est non nul, il spécifie une séquence terminée par un 0 de positions en pixels pour les tabulations dans le texte.
• Si tabStops est différent de zéro, cette valeur est utilisée comme espacement des tabulations (en pixels).

Notez que le rectangle de délimitation peut s’étendre à gauche de (0, 0), par exemple pour les polices en italique.

Les caractères de nouvelle ligne sont traités comme des sauts de ligne.

Malgré les différences de hauteur réelle des caractères, les hauteurs des rectangles de délimitation de « Yes » et « yes » sont identiques.

Le rectangle de délimitation renvoyé par cette fonction est légèrement plus grand que celui calculé par la fonction plus simple `boundingRect()`. Cette fonction utilise les paramètres ` maximum left ` et ` right ` de la police, nécessaires pour que le texte multiligne s’aligne correctement. De plus, les fonctions `fontHeight()` et ` lineSpacing()` sont utilisées pour calculer la hauteur, plutôt que les hauteurs individuelles des caractères.

Voir également horizontalAdvance(), QPainter::boundingRect() et Qt::Alignment.

qreal QFontMetricsF::capHeight() const

Renvoie la hauteur de majuscules de la police.

La hauteur des majuscules d’une police correspond à la hauteur d’une lettre majuscule au-dessus de la ligne de base. Il s’agit plus précisément de la hauteur des lettres majuscules plates – telles que le H ou le I – par opposition aux lettres arrondies comme le O ou aux lettres pointues comme le A, qui peuvent toutes deux présenter un dépassement.

Voir aussi ascent().

qreal QFontMetricsF::descent() const

Renvoie la descente de la police.

La descente correspond à la distance entre la ligne de base et le point le plus bas atteint par les caractères. (Notez que cela diffère de la valeur X, qui ajoute 1 pixel.) Dans la pratique, certains créateurs de polices s'écartent de cette règle, par exemple pour s'adapter à un caractère particulier ; il est donc possible (bien que rare) que cette valeur soit trop petite.

Voir également ascent().

QString QFontMetricsF::elidedText(const QString &text, Qt::TextElideMode mode, qreal width, int flags = 0) const

Si la chaîne « text » est plus longue que « width », renvoie une version tronquée de la chaîne (c'est-à-dire une chaîne contenant « ... »). Sinon, renvoie la chaîne d'origine.

Le paramètre mode spécifie si le texte est tronqué à gauche (par exemple, « ...tech »), au milieu (par exemple, « Tr...ch ») ou à droite (par exemple, « Trol... »).

La valeur de width est exprimée en pixels, et non en caractères.

L’argument ` flags ` est facultatif et ne prend actuellement en charge que la valeur ` Qt::TextShowMnemonic `.

La marque d’élision suit l’ layoutdirection. Par exemple, elle se trouvera à droite du texte pour les mises en page de droite à gauche si l’ mode est Qt::ElideLeft, et à gauche du texte si l’ mode est Qt::ElideRight.

qreal QFontMetricsF::fontDpi() const

Renvoie la résolution (DPI) de la police.

qreal QFontMetricsF::height() const

Renvoie la hauteur de la police.

Cette valeur est toujours égale à ascent() +descent().

Voir également leading() et lineSpacing().

[since 6.3] qreal QFontMetricsF::horizontalAdvance(const QString &text, const QTextOption &option) const

Renvoie l'avance horizontale, en pixels, d'un élément « text » mis en page à l'aide de « option ».

Cet espacement correspond à la distance nécessaire pour dessiner un caractère suivant après ` text`.

Cette fonction a été introduite dans Qt 6.3.

Voir également ` boundingRect()`().

qreal QFontMetricsF::horizontalAdvance(const QString &text, int length = -1) const

Renvoie l'avance horizontale, en pixels, des premiers caractères de length de text. Si length est négatif (valeur par défaut), la chaîne entière est utilisée. La longueur totale de text est analysée, même si length est nettement plus court.

L'avance correspond à la distance nécessaire pour tracer le caractère suivant après text.

Voir également boundingRect().

qreal QFontMetricsF::horizontalAdvance(QChar ch) const

Renvoie l'avance horizontale de l'ch de caractères en pixels. Il s'agit d'une distance appropriée pour dessiner un caractère suivant après ` ch`.

Certaines de ces mesures sont illustrées dans l’image de droite. Les rectangles sombres centraux correspondent à la valeur logique de `horizontalAdvance()` de chaque caractère. Les rectangles clairs extérieurs correspondent aux valeurs de ` leftBearing()` et ` rightBearing()` de chaque caractère. Notez que les écarts latéraux du « f » dans cette police particulière sont tous deux négatifs, tandis que ceux du « o » sont tous deux positifs.

Voir également boundingRect().

bool QFontMetricsF::inFont(QChar ch) const

Renvoie « true » si le caractère ch est un caractère valide dans la police ; sinon, renvoie « false ».

bool QFontMetricsF::inFontUcs4(uint ch) const

Renvoie ` true ` si le caractère indiqué par ` ch`, encodé en UCS-4/UTF-32, est un caractère valide dans la police ; sinon, renvoie ` false`.

qreal QFontMetricsF::leading() const

Renvoie l'interligne de la police.

Il s'agit de l'espacement naturel entre les lignes.

Voir aussi height() et lineSpacing().

qreal QFontMetricsF::leftBearing(QChar ch) const

Renvoie l'orientation à gauche du caractère ch dans la police.

Le décalage vers la gauche correspond à la distance vers la droite entre le pixel le plus à gauche du caractère et l'origine logique de ce dernier. Cette valeur est négative si les pixels du caractère s'étendent à gauche de l'origine logique.

Voir horizontalAdvance() pour une description graphique de cette métrique.

Voir également ` rightBearing()`, ` minLeftBearing()` et ` horizontalAdvance()`.

qreal QFontMetricsF::lineSpacing() const

Renvoie la distance entre deux lignes de base.

Cette valeur est toujours égale à leading() +height().

Voir également height() et leading().

qreal QFontMetricsF::lineWidth() const

Renvoie la largeur des lignes de soulignement et de barré, ajustée en fonction de la taille en points de la police.

Voir également underlinePos(), overlinePos() et strikeOutPos().

qreal QFontMetricsF::maxWidth() const

Renvoie la largeur du caractère le plus large de la police.

qreal QFontMetricsF::minLeftBearing() const

Renvoie le relèvement minimal à gauche de la police.

Il s'agit de la plus petite valeur d'leftBearing e (char) parmi tous les caractères de la police.

Notez que cette fonction peut être très lente si la police est volumineuse.

Voir également minRightBearing() et leftBearing().

qreal QFontMetricsF::minRightBearing() const

Renvoie le pas minimal vers la droite de la police.

Il s'agit de la plus petite valeur « rightBearing » (char) parmi tous les caractères de la police.

Notez que cette fonction peut être très lente si la police est volumineuse.

Voir également minLeftBearing() et rightBearing().

qreal QFontMetricsF::overlinePos() const

Renvoie la distance entre la ligne de base et l'endroit où une barre supérieure doit être tracée.

Voir également underlinePos(), strikeOutPos() et lineWidth().

qreal QFontMetricsF::rightBearing(QChar ch) const

Renvoie le décalage vers la droite du caractère ch dans la police.

L'alignement à droite correspond à la distance vers la gauche entre le pixel le plus à droite du caractère et l'origine logique du caractère suivant. Cette valeur est négative si les pixels du caractère s'étendent à droite de l'horizontalAdvance() du caractère.

Voir ` horizontalAdvance()` pour une description graphique de cette métrique.

Voir également leftBearing(), minRightBearing() et horizontalAdvance().

QSizeF QFontMetricsF::size(int flags, const QString &text, int tabStops = 0, int *tabArray = nullptr) const

Renvoie la taille en pixels des caractères contenus dans l'text donné.

L'argument ` flags ` correspond à la somme logique (OU) des indicateurs suivants :

• Qt::TextSingleLine ignore les caractères de nouvelle ligne.
• Qt::TextExpandTabs développe les tabulations (voir ci-dessous)
• Qt::TextShowMnemonic interprète « &x » comme x; c'est-à-dire souligné.
• Qt::TextWordWrap coupe le texte pour l'adapter au rectangle.

Ces indicateurs sont définis dans l’énumération Qt::TextFlag.

Si Qt::TextExpandTabs est défini dans flags, le comportement suivant est utilisé pour interpréter les caractères de tabulation dans le texte :

• Si tabArray est non nul, il spécifie une séquence terminée par un 0 de positions en pixels pour les tabulations dans le texte.
• Si « tabStops » est différent de zéro, cette valeur est utilisée comme espacement des tabulations (en pixels).

Les caractères de nouvelle ligne sont traités comme des sauts de ligne.

Remarque : malgré les différences de hauteur réelle des caractères, les hauteurs des rectangles englobants de « Yes » et « yes » sont identiques.

Voir aussi boundingRect().

qreal QFontMetricsF::strikeOutPos() const

Renvoie la distance entre la ligne de base et l'endroit où la ligne de strikeout doit être tracée.

Voir également underlinePos(), overlinePos() et lineWidth().

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

Remplace cette instance de métriques de police par other. Cette opération est très rapide et ne rencontre jamais d'échec.

QRectF QFontMetricsF::tightBoundingRect(const QString &text) const

Renvoie un rectangle de délimitation serré autour des caractères de la chaîne spécifiée par ` text`. Le rectangle de délimitation couvre toujours au moins l'ensemble des pixels que le texte couvrirait s'il était tracé en (0, 0).

Notez que le rectangle de délimitation peut s’étendre à gauche de (0, 0), par exemple pour les polices en italique, et que la largeur du rectangle renvoyé peut être différente de celle renvoyée par la méthode horizontalAdvance().

Si vous souhaitez connaître la largeur d’avance de la chaîne (pour disposer un ensemble de chaînes les unes à côté des autres), utilisez plutôt la méthode ` horizontalAdvance()`.

Les caractères de nouvelle ligne sont traités comme des caractères normaux, et non comme des sauts de ligne.

Voir également horizontalAdvance(), height() et boundingRect().

[since 6.3] QRectF QFontMetricsF::tightBoundingRect(const QString &text, const QTextOption &option) const

Renvoie un rectangle englobant serré autour des caractères de la chaîne spécifiée par ` text `, dont la mise en page est définie par ` option`. Le rectangle englobant couvre toujours au moins l'ensemble des pixels que le texte couvrirait s'il était dessiné à la position (0, 0).

Notez que le rectangle de délimitation peut s'étendre à gauche de (0, 0), par exemple pour les polices en italique, et que la largeur du rectangle renvoyé peut être différente de celle renvoyée par la méthode horizontalAdvance().

Si vous souhaitez connaître la largeur d’avancement de la chaîne (pour disposer plusieurs chaînes les unes à côté des autres), utilisez plutôt la méthode ` horizontalAdvance()`.

Les caractères de nouvelle ligne sont traités comme des caractères normaux, et non comme des sauts de ligne.

Cette fonction a été introduite dans Qt 6.3.

Voir également horizontalAdvance(), height() et boundingRect().

qreal QFontMetricsF::underlinePos() const

Renvoie la distance entre la ligne de base et l'endroit où un trait de soulignement doit être tracé.

Voir également overlinePos(), strikeOutPos() et lineWidth().

qreal QFontMetricsF::xHeight() const

Renvoie la hauteur « x » de la police. Celle-ci correspond souvent, mais pas toujours, à la hauteur du caractère « x ».

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

Renvoie ` true ` si les métriques de la police ne correspondent pas à celles de ` other ` ; sinon, renvoie ` false`.

Voir également operator==().

[noexcept] QFontMetricsF &QFontMetricsF::operator=(QFontMetricsF &&other)

Cette opération attribue l'other à cette instance QFontMetricsF.

QFontMetricsF &QFontMetricsF::operator=(const QFontMetrics &other)

Attribue la valeur « other » à cet objet.

QFontMetricsF &QFontMetricsF::operator=(const QFontMetricsF &fm)

Attribue les paramètres de police « fm » à cet objet de paramètres de police.

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

Renvoie true si les métriques de police sont égales à celles de other; sinon, renvoie false.

Deux métriques de police sont considérées comme égales si elles ont été construites à partir de la même QFont et si les périphériques de dessin pour lesquels elles ont été construites sont considérés comme compatibles.