QFontInfo

La classe QFontInfo fournit des informations générales à propos des polices d'écriture. Plus d'informations...

#include <QFontInfo>

Description détaillée

La classe QFontInfo fournit des informations générales à propos des polices d'écriture.

Cette classe fournit les mêmes fonctions d'accès que QFont, par exemple family(), pointSize(), italic(), weight(), fixedPitch(), styleHint(), etc. Alors que les fonctions d'accès de QFont retournent les valeurs qui ont été définies, un objet QFontInfo retourne les valeurs qui s'appliquent à la police d'écriture qui sera effectivement utilisée pour dessiner le texte.

Par exemple, quand le programme tente d'afficher la police Courier 25pt sur une machine qui a une police Courier 24pt dont la taille n'est pas modifiable, QFont va (normalement) utiliser la police Courier 24pt pour le rendu. Dans ce cas, QFont::pointSize() retourne 25 et QFontInfo::pointSize() retourne 24.

Un objet QFontInfo peut être créé de trois façons :

1. Appeler le constructeur de QFontInfo avec un QFont crée un objet d'informations pour une police d'écran, c'est-à-dire que cette police d'écriture peut ne pas être une police d'impression. Si la police est changée par la suite, l'objet d'informations ne sera pas mis à jour. (Note : si vous utilisez une police d'impression, les valeurs retournées peuvent être inexactes ; les polices d'impression ne sont pas toujours accessibles : dans ce cas, elle est remplacée par la police d'écran la plus proche) ;
2. QWidget::fontInfo() retourne les informations de la police d'écriture d'un widget. Cela revient au même que d'appeler QFontInfo(widget->font()). Si la police du widget est changée par la suite, l'objet d'informations n'est pas mis à jour ;
3. QPainter::fontInfo() retourne les informations sur la police utilisée par un objet QPainter. Si cette police est changée plus tard, l'objet d'informations n'est pas mis à jour.

Voir aussi QFont, QFontMetrics et QFontDatabase.

Fonctions membres

QFontInfo::QFontInfo ( const QFont & font )

Construit un objet d'informations de police pour font.

La police doit être une police pour écran, c'est-à-dire une police que vous utilisez quand vous affichez du texte dans des widgets ou des pixmaps mais pas dans un QPicture ou QPrinter.

L'objet garde l'information sur la police passée au constructeur au moment où il est créé et n'est pas mis à jour si les attributs de la police sont changés par la suite.

Utilisez QPainter::fontInfo() pour obtenir les informations sur la police lors de la peinture. Cette méthode donnera des résultats corrects même si vous peignez sur un périphérique qui n'est pas compatible avec l'écran.

QFontInfo::QFontInfo ( const QFontInfo & fi )

Construit une copie de fi.

QFontInfo::~QFontInfo ()

Détruit l'objet d'informations de police.

bool QFontInfo::bold () const

Retourne true si weight() retourne une valeur plus grande que QFont::Normal ; sinon retourne false.

Voir aussi weight() et Font::bold().

bool QFontInfo::exactMatch () const

Retourne true si la police du système de fenêtrage correspond exactement à celle spécifiée par la police ; sinon retourne false.

Voir aussi QFont::exactMatch().

QString QFontInfo::family () const

Retourne le nom de la famille de la police du système de fenêtrage correspondante.

Voir aussi QFont::family().

bool QFontInfo::fixedPitch () const

Retourne la valeur fixée du pas de la police du système de fenêtrage correspondante.

Voir aussi QFont::fixedPitch().

bool QFontInfo::italic () const

Retourne la valeur de l'italique de la police du système de fenêtrage correspondante.

Voir aussi QFont::italic().

int QFontInfo::pixelSize () const

Retourne la taille en pixels de la police du système de fenêtrage correspondante.

Voir aussi QFont::pointSize().

int QFontInfo::pointSize () const

Retourne la taille en points de la police du système de fenêtrage correspondante.

Voir aussi pointSizeF() et QFont::pointSize().

qreal QFontInfo::pointSizeF () const

Retourne la taille en points de la police système de la fenêtre sélectionnée.

Voir aussi QFont::pointSizeF().

bool QFontInfo::rawMode () const

Retoure true si la police est en mode brut ; sinon retourne false.

S'il s'agit d'une police en mode brut, toutes les autres fonctions de QFontInfo retourneront la même valeur définie dans QFont, indépendamment de la police effectivement utilisée.

Voir aussi QFont::rawMode().

QFont::Style QFontInfo::style () const

Retourne la valeur du style de la police du système de fenêtrage correspondante.

Voir aussi QFont::style().

QFont::StyleHint QFontInfo::styleHint () const

Retourne le style de la police du système de fenêtrage correspondante.

Actuellement retourne uniquement le conseil de style défini dans QFont.

Voir aussi QFont::styleHint() et QFont::StyleHint.

int QFontInfo::weight () const

Retourne l'épaisseur de la police du système de fenêtrage correspondante.

Voir aussi QFont::weight() et bold().

QFontInfo & QFontInfo::operator= ( const QFontInfo & fi )

Assigne les informations sur la police à fi.

Remerciements

Merci à Adrien Morel pour la traduction ainsi qu'à Jonathan Courtois, Thibaut Cuvelier et Maxime Gault pour la relecture !