QFontInfo Class
La classe QFontInfo fournit des informations générales sur les polices de caractères. Plus d'informations...
| En-tête : | #include <QFontInfo> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
- Liste de tous les membres, y compris les membres hérités
- Membres dépréciés
- QFontInfo fait partie des classes partagées implicitement.
Note : Toutes les fonctions de cette classe sont réentrantes.
Fonctions publiques
| QFontInfo(const QFont &font) | |
| QFontInfo(const QFontInfo &fi) | |
| ~QFontInfo() | |
| bool | bold() const |
| bool | exactMatch() const |
| QString | family() const |
| bool | fixedPitch() const |
| bool | italic() const |
| int | pixelSize() const |
| int | pointSize() const |
| qreal | pointSizeF() const |
| QFont::Style | style() const |
| QFont::StyleHint | styleHint() const |
| QString | styleName() const |
| void | swap(QFontInfo &other) |
(since 6.9) QList<QFontVariableAxis> | variableAxes() const |
| int | weight() const |
| QFontInfo & | operator=(const QFontInfo &fi) |
Description détaillée
La classe QFontInfo fournit les mêmes fonctions d'accès que QFont, par exemple family(), pointSize(), italic(), weight(), fixedPitch(), styleHint(), etc. Mais alors que les fonctions d'accès de QFont renvoient les valeurs qui ont été définies, un objet QFontInfo renvoie les valeurs qui s'appliquent à la police qui sera effectivement utilisée pour dessiner le texte.
Par exemple, lorsque le programme demande une police Courier de 25 pt sur une machine qui possède une police Courier de 24 pt non extensible, QFont utilisera (normalement) la police Courier de 24 pt pour le rendu. Dans ce cas, QFont::pointSize() renvoie 25 et QFontInfo::pointSize() renvoie 24.
Il existe trois façons de créer un objet QFontInfo.
- L'appel au constructeur de QFontInfo avec une adresse QFont crée un objet d'information sur les polices pour une police compatible avec l'écran, c'est-à-dire que la police ne peut pas être une police d'imprimante. Si la police est modifiée ultérieurement, l'objet font info n' est pas mis à jour.
(Remarque : si vous utilisez une police d'imprimante, les valeurs renvoyées peuvent être inexactes. Les polices d'imprimante n'étant pas toujours accessibles, la police d'écran la plus proche est utilisée si une police d'imprimante est fournie).
- QWidget::fontInfo() renvoie les informations de police pour la police d'un widget. Cela équivaut à appeler QFontInfo(widget->font()). Si la police du widget est modifiée ultérieurement, l'objet font info n' est pas mis à jour.
- QPainter::fontInfo() renvoie les informations de police pour la police actuelle d'un peintre. Si la police du peintre est modifiée ultérieurement, l'objet font info n'est pas mis à jour.
Vérification de l'existence d'une police
Il est parfois utile de vérifier l'existence d'une police avant d'essayer de l'utiliser. La manière la plus complète de le faire est d'utiliser exactMatch() :
const QFont segoeFont(QLatin1String("Segoe UI")); if (QFontInfo(segoeFont).exactMatch()) { // Use the font... }
Cependant, cette recherche approfondie des familles peut être coûteuse sur certaines plateformes. QFontDatabase::families().contains() est une alternative plus rapide, mais moins complète :
const QLatin1String segoeUiFamilyName("Segoe UI"); if (QFontDatabase::families().contains(segoeUiFamilyName)) { const QFont segoeFont(segoeUiFamilyName); // Use the font... }
Elle est moins approfondie car la recherche n'est pas complète : certains alias de familles de polices peuvent être absents de la liste. Toutefois, cette approche permet d'accélérer le démarrage des applications et doit donc être privilégiée dans la mesure du possible.
Voir aussi QFont, QFontMetrics, et QFontDatabase.
Documentation des fonctions membres
QFontInfo::QFontInfo(const QFont &font)
Construit un objet d'information sur les polices de caractères pour font.
La police doit être compatible avec l'écran, c'est-à-dire une police que vous utilisez pour dessiner du texte dans widgets ou pixmaps, et non QPicture ou QPrinter.
L'objet font info contient les informations relatives à la police qui sont passées dans le 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 QPainter::fontInfo() pour obtenir les informations sur la police lorsque vous peignez. Cela donnera des résultats corrects même si l'on peint sur un dispositif de peinture qui n'est pas compatible avec l'écran.
Voir aussi Checking for the existence of a font.
QFontInfo::QFontInfo(const QFontInfo &fi)
Construit une copie de fi.
[noexcept] QFontInfo::~QFontInfo()
Détruit l'objet d'information sur les polices.
bool QFontInfo::bold() const
Renvoie true si weight() renvoie une valeur supérieure à QFont::Normal; sinon, renvoie false.
Voir aussi weight() et QFont::bold().
bool QFontInfo::exactMatch() const
Renvoie true si la police du système de fenêtres correspondante est exactement la même que celle spécifiée par la police ; sinon, renvoie false.
Voir aussi QFont::exactMatch().
QString QFontInfo::family() const
Renvoie le nom de famille de la police du système de fenêtrage correspondant.
Voir aussi QFont::family() et Checking for the existence of a font.
bool QFontInfo::fixedPitch() const
Renvoie la valeur de hauteur fixe de la police de caractères du système de fenêtres correspondant.
Voir aussi QFont::fixedPitch().
bool QFontInfo::italic() const
Renvoie la valeur italique de la police du système de fenêtres correspondante.
Voir aussi QFont::italic().
int QFontInfo::pixelSize() const
Renvoie la taille en pixels de la police système de la fenêtre correspondante.
Voir aussi QFont::pointSize().
int QFontInfo::pointSize() const
Renvoie la taille des points de la police du système de fenêtres correspondant.
Voir aussi pointSizeF() et QFont::pointSize().
qreal QFontInfo::pointSizeF() const
Renvoie la taille des points de la police du système de fenêtres correspondant.
Voir aussi QFont::pointSizeF().
QFont::Style QFontInfo::style() const
Renvoie la valeur de style de la police du système de fenêtres correspondante.
Voir aussi QFont::style().
QFont::StyleHint QFontInfo::styleHint() const
Renvoie le style de la police du système de fenêtres correspondant.
Actuellement, il ne renvoie que l'indice de style défini dans QFont.
Voir aussi QFont::styleHint() et QFont::StyleHint.
QString QFontInfo::styleName() const
Renvoie le nom du style de la police du système de fenêtrage correspondant sur les systèmes qui le prennent en charge.
Voir aussi QFont::styleName().
[noexcept] void QFontInfo::swap(QFontInfo &other)
Remplace cette instance d'informations sur les polices par other. Cette opération est très rapide et n'échoue jamais.
[since 6.9] QList<QFontVariableAxis> QFontInfo::variableAxes() const
Si la police est une police variable, cette fonction renvoie la liste des axes pris en charge par la police.
Voir setVariableAxis() pour plus de détails sur les axes variables.
Cette fonction a été introduite dans Qt 6.9.
int QFontInfo::weight() const
Renvoie le poids de la police du système de fenêtres correspondante.
Voir aussi QFont::weight() et bold().
QFontInfo &QFontInfo::operator=(const QFontInfo &fi)
Attribue les informations de police à fi.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.