QFont

La classe QFont sp�cifie une fonte utilis�e pour dessiner du texte. Plus d'informations...

#include <QFont>

Voir la position dans l'arbre des classes.

Note : toutes les fonctions de cette classe sont r�entrantes.

Description d�taill�e

La classe QFont sp�cifie une fonte utilis�e pour dessiner du texte.

Lorsque vous cr�ez un objet QFont, vous sp�cifiez les diff�rents attributs que vous voulez que la fonte poss�de. Qt va utiliser la fonte avec les attributs sp�cifi�s, ou, si aucune fonte correspondante n'existe, la fonte install�e la plus proche. Les attributs de la fonte r�ellement utilis�e sont r�cup�rables � l'aide d'un objet QFontInfo. Si le syst�me de fen�tre fournit une fonte correspondant exactement � celle voulue, la fonction exactMatch() retourne true. Utilisez QFontMetrics pour r�cup�rer les mesures, par exemple la longueur en pixels d'une chaine de caract�res avec QFontMetrics::width().

Notez qu'une instance de QApplication doit exister avant que QFont soit utilisable. Vous pouvez d�finir la fonte par d�faut pour l'application avec la fonction QApplication::setFont().fontes

Si une fonte choisie ne poss�de pas tous les caract�res n�cessaires, QFont va essayer de trouver les caract�res manquants dans les fontes les plus proches. Lorsqu'un QPainter dessine un caract�re � partir d'une fonte le QFont va signaler s'il poss�de ce caract�re ou non ; s'il ne l'a pas, QPainter dessinera un rectangle vide.

Cr�ez les QFont comme suit :

 QFont serifFont("Times", 10, QFont::Bold);
 
 QFont sansFont("Helvetica [Cronyx]", 12);

Les attributs d�finis dans le constructeur peuvent aussi �tre d�finis plus tard avec les fonctions setFamily(), setPointSize(), setPointSizeFloat(), setWeight() et setItalic(). Les autres attributs doivent �tre d�finis apr�s la construction, par exemple, setBold(), setUnderline(), setOverline(), setStrikeOut() et setFixedPitch(). Les objets QFontInfo doivent �tre cr�es apr�s que les attributs de la fonte ont �t� d�finis. Un objet QFontInfo ne changera pas, m�me si vous modifiez les attributs de la fonte. Les accesseurs correspondants (par exemple, family(), pointSize(), etc.) retournent les valeurs qui ont �t� d�finies, m�me si les valeurs utilis�es sont diff�rentes. Les valeurs r�elles sont disponibles � partir d'un objet QFontInfo.

Si la police demand�e est indisponible, vous pouvez influencer l'algorithme de correspondance de fonte en choisissant des QFont::StyleHint et QFont::StyleStrategy particuliers avec la fonction setStyleHint(). La police par d�faut (correspondant � l'indication de style courante) est retourn�e par la fonction defaultFamily().

L'algorithme de correspondance de fonte poss�de une lastResortFamily() et unelastResortFont() pour les cas o� aucune correspondance n'est trouv�e. Vous pouvez d�signer des substitutions pour les noms de police avec les fonctions insertSubstitution() et insertSubstitutions(). Les substitutions peuvent �tre supprim�es avec la fonction removeSubstitution(). Utilisez la fonction substitute() pour r�cup�rer le premier substitut de la police ou le nom de la police lui-m�me s'il n'y a pas de substitutions. Utilisez la fonction substitutes() pour r�cup�rer une liste des substituts de la police (qui peut �tre vide).

Chaque QFont poss�de une cl� que vous pouvez utiliser, par exemple, comme cl� dans un cache ou un dictionnaire. Si vous souhaitez enregistrer les pr�f�rences de l'utilisateur pour une fonte vous pouvez utiliser QSettings, en �crivant les informations avec la fonction toString() et en les lisant avec la fonction fromString(). Les op�rateurs operator<<() et operator>>() sont disponibles mais s'utilisent avec les flux de donn�es.

Il est possible de d�finir la hauteur des caract�res affich�s � l'�cran � un nombre sp�cifi� en pixels avec la fonction setPixelSize() ; cependant, la fonction setPointSize() permet d'obtenir un effet similaire en restant ind�pendant du p�riph�rique.

Dans X11 vous pouvez d�finir une fonte en utilisant le nom sp�cifique au syst�me avec la fonction setRawName().

Le chargement de fontes peut �tre co�teux en termes de performance, particuli�rement sous X11. QFont contient de nombreuses optimisations afin de rendre la copie des objets QFont rapide et de mettre en cache les r�sultats des fonctions lentes du syst�me de fen�trage sur lequel QFont repose.

L'algorithme de correspondance de fonte fonctionne comme suit :

1. La police sp�cifi�e est recherch�e ;
2. Si elle n'est pas trouv�e, le styleHint() est utilis� pour s�lectionner une police de remplacement ;
3. Chaque police de remplacement est recherch�e ;
4. Si aucune n'est trouv�e ou qu'il n'y a pas de styleHint(), « helvetica » est recherch�e ;
5. Si « helvetica » n'est pas trouv�e, Qt essaiera de trouver la police lastResortFamily() ;
6. Si la lastResortFamily() n'est pas trouv�e Qt utilisera lastResortFont(), qui retourne toujours un nom ;

Notez que l'algorithme r�el de correspondance de fonte varie selon la plateforme.

Dans Windows, une requ�te pour la police de caract�res « Courier » sera automatiquement chang�e en « Courier New », une version am�lior�e de Courier qui permet le redimensionnement libre sans effet d'escalier. L'ancienne police de caract�res bitmap « Courier » peut �tre s�lectionn�e en d�finissant la strat�gie de style PreferBitmap (voir setStyleStrategy()).

Une fois la police de caract�res trouv�e, la correspondance des attributs restants est v�rifi�e par ordre de priorit� :

1. fixedPitch() ;
2. pointSize() (voir ci-dessous) ;
3. weight() ;
4. style().

Si vous avez une fonte � laquelle la police correspond, m�me si aucun des autres attributs ne correspond, cette fonte sera choisie m�me si une fonte ayant une police diff�rente mais que les autres attributs correspondants existent. Ce comportement est d� au caract�re dominant de la police dans les crit�res de recherche.

La taille du point est d�finie comme correspondante si l'�cart ne d�passe pas 20 % de la taille de point demand�e. Lorsque plusieurs fontes correspondent et que seule la taille du point diff�re, la fonte avec la taille de point la plus proche de celle voulue sera choisie.

Les valeurs r�elles de police, taille, graisse, et autres attributs de fonte utilis�s pour dessiner le texte d�pendent de ce qui est disponible pour la fonte choisie dans le syst�me. Un objet QFontInfo peut �tre utilis� pour d�terminer les valeurs r�elles utilis�es lors du dessin d'un texte.

Exemples :

 QFont f("Helvetica");

Si vous poss�dez � la fois les polices Helvetica Adobe et Cronyx, vous aurez l'une des deux.

 QFont f("Helvetica [Cronyx]");

Vous pouvez sp�cifier la forge que vous souhaitez dans le nom de police. La police de caract�res f dans l'exemple ci-dessus sera d�finie � « Helvetica [Cronyx] ».

Pour d�terminer les attributs de la fonte r�ellement utilis�e dans le syst�me, utilisez un objet QFontInfo, par exemple :

 QFontInfo info(f1);
 
 QString family = info.family();

Pour trouver les m�triques de la fonte utilisez un objet QFontMetrics, par exemple :

 QFontMetrics fm(f1);
 
 int textWidthInPixels = fm.width("How many pixels wide is this text?");
 
 int textHeightInPixels = fm.height();

Pour plus d'informations sur les fontes, voir la FAQ comp.fonts. Les informations sur l'encodage peuvent �tre trouv�es sur la page de Roman Czyborra.

Voir aussi QFontComboBox, QFontMetrics, QFontInfo, QFontDatabase et exemple : jeu de caract�res.

Type

enum QFont::Capitalization

Option de rendu pour le texte sur lequel cette fonte s'applique.

Cette �num�ration a �t� introduite ou modifi�e dans Qt 4.4.

enum QFont::SpacingType

Cette �num�ration a �t� introduite ou modifi�e dans Qt 4.4.

enum QFont::Stretch

Valeurs d'�largissement pr�d�finies qui suivent la convention de nommage CSS. Plus la valeur est haute, plus le texte est �largi.

Voir aussi setStretch() et stretch().

enum QFont::Style

Cette �num�ration d�crit les diff�rents styles de glyphes utilis�s pour afficher le texte.

Voir aussi Weight.

enum QFont::StyleHint

Les indications de style sont utilis�es par l'algorithme de correspondance de fonte pour trouver une police par d�faut appropri�e si la police de caract�res s�lectionn�e n'est pas disponible.

enum QFont::StyleStrategy

La strat�gie de style indique � l'algorithme de correspondance des fontes quel type de police utiliser pour trouver une police par d�faut appropri�e.

Les strat�gies suivantes sont disponibles :

Toutes les �num�rations ci-dessus peuvent �tre combin�es avec l'un de ces indicateurs :

enum QFont::Weight

Qt utilise une �chelle de graisse de 0 � 99 similaire � celui de Windows ou CSS, mais diff�rent. Une graisse de 0 est ultrafine, alors qu'une graisse de 99 sera extr�mement noire.

Cette �num�ration contient les graisses de fonte pr�d�finies :

Fonctions membres

QFont::QFont ()

Construit un objet fonte qui utilise la fonte par d�faut de l'application.

Voir aussi QApplication::setFont() et QApplication::font().

QFont::QFont ( const QString & family, int pointSize = -1, int weight = -1, bool italic = false )

Construit un objet fonte avec les param�tres de police (family), taille de point (pointSize), graisse (weight) et d'indicateur d'italique (italic) sp�cifi�s.

Si la taille de point pointSize est z�ro ou n�gative, la taille de point de la fonte est d�finie � une valeur donn�e par le syst�me. G�n�ralement, elle est de 12 points sauf sur Symbian sur lequel la valeur de 7 points est utilis�e.

Le nom de police family peut inclure optionnellement un nom de forge, par exemple, « Helvetica [Cronyx] ». Si la police family est disponible dans plus d'une forge et que la forge n'est pas sp�cifi�e, une forge arbitraire sera choisie. Si la police n'est pas disponible une police sera d�finie avec l'algorithme de correspondance de fonte.

Voir aussi Weight, setFamily(), setPointSize(), setWeight(), setItalic(), setStyleHint() et QApplication::font().

QFont::QFont ( const QFont & font, QPaintDevice * pd )

Construit une fonte � partir de la fonte font pour utilisation sur le p�riph�rique de dessin pd.

QFont::QFont ( const QFont & font )

Construit une fonte par copie de la fonte font.

QFont::~QFont ()

D�truit l'objet fonte et lib�re les ressources allou�es.

bool QFont::bold () const

Retourne true si la graisse weight() est plus grande que QFont::Normal ; sinon retourne false.

Voir aussi weight(), setBold() et QFontInfo::bold().

Capitalization QFont::capitalization () const

Retourne le type actuel de capitalisation de la fonte.

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi setCapitalization().

QString QFont::defaultFamily () const

Retourne le nom de police qui correspond � l'indication de style actuelle.

Voir aussi StyleHint, styleHint() et setStyleHint().

bool QFont::exactMatch () const

Retourne true si une fonte du syst�me correspond exactement aux param�tres de cette fonte.

Voir aussi QFontInfo.

QString QFont::family () const

Retourne le nom de police demand�, c'est-�-dire le nom d�fini dans le constructeur ou par le dernier appel � setFont().

Voir aussi setFamily(), substitutes() et substitute().

bool QFont::fixedPitch () const

Retourne true si une hauteur fixe a �t� d�finie ; sinon retourne false.

Voir aussi setFixedPitch() et QFontInfo::fixedPitch().

FT_Face QFont::freetypeFace () const

Retourne l'identifiant de la face FreeType principale de la fonte. Si la fusion de fonte n'est pas d�sactiv�e un QFont peut contenir plusieurs fontes physiques.

Retourne 0 si la fonte ne contient pas de face FreeType.

Note : cette fonction n'est disponible que sur les plateformes qui fournissent la biblioth�que FreeType, c'est-�-dire X11 et certaines plateformes embarqu�es Linux.

bool QFont::fromString ( const QString & descrip )

D�finit la fonte pour la faire correspondre � la description descrip. La description est une liste d'attributs de fonte s�par�s par des virgules, comme retourn�e par la fonction toString().

Voir aussi toString().

HFONT QFont::handle () const

Retourne l'identifiant du syst�me de la fonte, pour les acc�s de bas niveau. L'utilisation de cette fonction n'est pas portable.

void QFont::insertSubstitution ( const QString & familyName, const QString & substituteName ) [static]

Ins�re le nom substituteName dans la table de substitutions pour le nom de police familyName.

Voir aussi insertSubstitutions(), removeSubstitution(), substitutions(), substitute() et substitutes().

void QFont::insertSubstitutions ( const QString & familyName, const QStringList & substituteNames ) [static]

Ins�re la liste de noms de police substituteNames dans la liste de substitution du nom de police familyName.

Voir aussi insertSubstitution(), removeSubstitution(), substitutions() et substitute().

bool QFont::isCopyOf ( const QFont & f ) const

Retourne true si cette fonte est une copie de f, c'est-�-dire si l'une des deux a �t� cr��e comme copie de l'autre et qu'elles n'ont pas �t� modifi�es depuis. Cette fonction est plus stricte que l'�galit�.

Voir aussi operator=() et operator==().

bool QFont::italic () const

Retourne true si le style() de la fonte n'est pas QFont::StyleNormal

Voir aussi setItalic() et style().

bool QFont::kerning () const

Retourne true si la technique de kerning devait �tre utilis�e lors du dessin du texte avec cette fonte.

Voir aussi setKerning().

QString QFont::key () const

Retourne la cl� de la fonte, une repr�sentation textuelle de la fonte. Cette valeur est typiquement utilis�e dans les caches ou les dictionnaires de fontes.

Voir aussi QMap.

QString QFont::lastResortFamily () const

Retourne le nom de police d�finie comme « dernier recours ».

L'impl�mentation actuelle essaie une grande vari�t� de nom de polices communes, retournant la premi�re trouv�e. Il est possible qu'aucune police ne soit trouv�e, la fonction retournera dans ce cas une chaine de caract�res vide.

Voir aussi lastResortFont().

QString QFont::lastResortFont () const

Retourne le nom de fonte de « dernier recours » pour l'algorithme de correspondance de fonte. Cette fonction est utilis�e en dernier recours si le nom de police de dernier recours n'est pas disponible. Elle va toujours retourner un nom, si n�cessaire ce nom sera quelque chose comme « fixed » ou « system ».

L'impl�mentation courante essaie une grande vari�t� de nom de polices, retournant la premi�re qu'il trouve. L'impl�mentation peut changer � tout moment, mais cette fonction retournera toujours une chaine de caract�res non vide.

Il est th�oriquement possible qu'il n'y ait pas de lastResortFont() Dans ce cas Qt, abandonnera en envoyant un message d'erreur. Nous n'avons pas r�ussi � identifier un tel cas. Veuillez rapporter un bogue si cela vous arrive, avec si possible la liste des fontes install�es.

Voir aussi lastResortFamily() et rawName().

qreal QFont::letterSpacing () const

Retourne l'espacement des lettres pour cette fonte.

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi setLetterSpacing(), letterSpacingType() et setWordSpacing().

SpacingType QFont::letterSpacingType () const

Retourne le type d'espacement utilis� pour l'espacement des lettres.

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi letterSpacing(), setLetterSpacing() et setWordSpacing().

quint32 QFont::macFontID () const

Retourne un ATSUFontID

bool QFont::overline () const

Retourne true si le surlignage (trait au-dessus de la ligne) est activ� ; sinon retourne false.

Voir aussi setOverline().

int QFont::pixelSize () const

Retourne la taille en pixels de la fonte si celle-ci a �t� d�finie avec la fonction setPixelSize(). Retourne -1 si la taille a �t� d�finie avec la fonction setPointSize() ou setPointSizeF().

Voir aussi setPixelSize(), pointSize(), QFontInfo::pointSize() et QFontInfo::pixelSize().

int QFont::pointSize () const

Retourne la taille en points de la fonte. Retourne -1 si la taille a �t� sp�cifi�e en pixels.

Voir aussi setPointSize() et pointSizeF().

qreal QFont::pointSizeF () const

Retourne la taille en points de la fonte. Retourne -1 si la taille a �t� d�finie en pixels.

Voir aussi pointSize(), setPointSizeF(), pixelSize(), QFontInfo::pointSize() et QFontInfo::pixelSize().

bool QFont::rawMode () const

Retourne true si le mode brut est utilis� pour la correspondance du nom de la fonte ; sinon retourne false.

Voir aussi setRawMode() et rawName().

QString QFont::rawName () const

Retourne le nom de la fonte utilis�e par le syst�me de fen�tre sous-jacent.

Avec X11, cette fonction retournera une chaine de caract�res vide si Qt a �t� compil� avec le support de FontConfig ; sinon, le XLFD (X Logical Font Description) est retourn�.

L'utilisation de la valeur retourn�e n'est en g�n�ral pas portable.

Voir aussi setRawName().

void QFont::removeSubstitution ( const QString & familyName ) [static]

Retire toutes les substitutions pour le nom familyName.

Voir aussi insertSubstitutions(), insertSubstitution(), substitutions() et substitute().

QFont QFont::resolve ( const QFont & other ) const

Retourne un nouveau QFont dont les attributs qui ne sont pas encore d�finis pour cette fonte sont copi�s � partir de other.

void QFont::setBold ( bool enable )

Si enable est d�fini � true, la graisse de la fonte est d�finie � QFont::Bold ; sinon, la graisse est d�finie � QFont::Normal.

Pour un contr�le plus fin de la mise en gras, utilisez la fonction setWeight().

Voir aussi bold() et setWeight().

void QFont::setCapitalization ( Capitalization caps )

D�finit la capitalisation du texte de cette fonte � caps.

Une capitalisation de la fonte fait que le texte apparait dans le mode s�lectionn� de capitalisation.

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi capitalization().

void QFont::setFamily ( const QString & family )

D�finit le nom de police de la fonte. Le nom n'est pas sensible � la casse et peut contenir un nom de forge.

Le nom family peut optionnellement inclure un nom de forge, par exemple, « Helvetica [Cronyx] ». Si le nom family est disponible dans plus d'une forge et qu'aucune forge n'est sp�cifi�e, une forge est choisie arbitrairement. Si la police n'est pas disponible une police sera choisie en utilisant l'algorithme de correspondance des fontes.

Voir aussi family(), setStyleHint() et QFontInfo.

void QFont::setFixedPitch ( bool enable )

Si enable est d�fini � true, active la hauteur fixe ; sinon la hauteur fixe est d�sactiv�e.

Voir aussi fixedPitch() et QFontInfo.

void QFont::setItalic ( bool enable )

D�finit le style() de la fonte � QFont::StyleItalic si enable est d�fini � true ; sinon le style est d�fini � QFont::StyleNormal.

Voir aussi italic() et QFontInfo.

void QFont::setKerning ( bool enable )

Active la technique de kerning pour cette fonte si enable est d�fini � true ; sinon la technique est d�sactiv�e. Par d�faut, cette technique est activ�e.

Lorsque la technique de kerning est activ�e, les m�triques des glyphes ne s'additionnent plus, m�me pour les textes en caract�res latins. En d'autres mots, le postulat que width(‹a›) + width(‹b›) est �gal � width(« ab ») n'est plus n�cessairement vrai.

Voir aussi kerning() et QFontMetrics.

void QFont::setLetterSpacing ( SpacingType type, qreal spacing )

D�finit l'espacement des lettres pour la fonte � spacing et le type d'espacement � type.

L'espacement des lettres modifie l'espacement par d�faut entre les lettres de la fonte. L'espacement entre les lettres peut �tre rendu plus petit ou plus grand.

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi letterSpacing(), letterSpacingType() et setWordSpacing().

void QFont::setOverline ( bool enable )

Si enable est d�fini � true, le surlignage (ligne au-dessus du texte) est activ� ; sinon le surlignage est d�sactiv�.

Voir aussi overline() et QFontInfo.

void QFont::setPixelSize ( int pixelSize )

D�finit la taille de la fonte � pixelSize pixels.

L'utilisation de cette fonction rend la fonte d�pendante du p�riph�rique. Utilisez setPointSize() ou setPointSizeF() pour d�finir une taille ind�pendante du p�riph�rique.

Voir aussi pixelSize().

void QFont::setPointSize ( int pointSize )

D�finit la taille du point � pointSize. La taille du point doit �tre sup�rieure � z�ro.

Voir aussi pointSize() et setPointSizeF().

void QFont::setPointSizeF ( qreal pointSize )

D�finit la taille du point � pointSize. La taille du point doit �tre sup�rieure � z�ro. La pr�cision requise peut ne pas �tre accept�e sur toutes les plateformes.

Voir aussi pointSizeF(), setPointSize() et setPixelSize().

void QFont::setRawMode ( bool enable )

Si enable est d�fini � true, le mode brut est activ� ; sinon le mode brut est d�sactiv�. Cette fonction n'est effective que sous X11.

Si le mode brut est activ�, Qt va rechercher une fonte X ayant un nom de police complet correspondant au nom de la police demand�e, ignorant toutes les autres valeurs d�finies pour la QFont. Si le nom de la police correspond � plusieurs fontes, Qt utilisera la premi�re fonte retourn�e par X. QFontInfo ne peut pas �tre utilis� pour r�cup�rer les informations sur une QFont lors de l'utilisation du mode brut (il retournera les valeurs d�finies dans la QFont pour tous les param�tres, y compris le nom de police).

Attention : n'utilisez pas le mode brut si ce n'est pas r�ellement n�cessaire ! Dans la plupart des cas (si ce n'est tous) setRawName() est un bien meilleur choix.

Voir aussi rawMode() et setRawName().

void QFont::setRawName ( const QString & name )

D�finit une fonte par son nom sp�cifique au syst�me. Cette fonction est particuli�rement utile sous X, o� les param�tres des fontes syst�me (par exemple, les ressources X) sont disponibles sous le format XLFD (X Logical Font Description) seulement. Vous pouvez passer un XLFD comme nom (name) � cette fonction.

Une fonte d�finie avec la fonction setRawName() est toujours une QFont compl�tement d�finie. Elle peut �tre modifi�e (par exemple avec setItalic()) ou questionn�e (par exemple avec italic()) et elle est aussi appropri�e pour le rendu de texte riche.

Si la base de donn�es interne de Qt ne peut r�soudre le nom brut, la fonte devient une fonte brute avec pour nom de police name.

Notez que l'impl�mentation actuelle ne prend pas en charge les jokers correctement pour les XLFD et que les alias de fonte (fichier fonts.alias dans le r�pertoire de fontes de X11) ne sont pas g�r�s.

Voir aussi rawName(), setRawMode() et setFamily().

void QFont::setStretch ( int factor )

D�finit le facteur d'�tirement pour la fonte.

Le facteur d'�tirement modifie la largeur de tous les caract�res de la fonte par le facteur factor en pourcentage. Par exemple, d�finir le facteur factor � 150 fait que tous les caract�res de la fonte sont 1,5 fois (c'est-�-dire 150 %) plus larges. Le facteur par d�faut est 100. Le facteur minimum est 1 et le maximum est 4000.

Le facteur d'�tirement n'est appliqu� que sur les fontes vectorielles. Le facteur d'�tirement est ignor� pour les fontes bitmaps.

Note : QFont ne peut �tirer les fontes XLFD. Lors du chargement d'une fonte XLFD sous X11, le facteur d'�tirement est d�fini � l'aide d'un ensemble de valeurs pr�d�finies pour le champ SETWIDTH_NAME du XLFD.

Voir aussi stretch() et QFont::Stretch.

void QFont::setStrikeOut ( bool enable )

Si enable est d�fini � true, barre la fonte ; sinon d�sactive la barre.

Voir aussi strikeOut() et QFontInfo.

void QFont::setStyle ( Style style )

D�finit le style de la fonte � style.

Voir aussi style(), italic() et QFontInfo.

void QFont::setStyleHint ( StyleHint hint, StyleStrategy strategy = PreferDefault )

D�finit l'indication de style et la strat�gie � hint et strategy, respectivement.

S'il n'y a pas d'indication de style d�finie explicitement la valeur par d�faut est AnyStyle et la strat�gie de style est PreferDefault.

Qt ne g�re pas les indications de style sous X11 car cette information n'est pas fournie par le syst�me de fen�tres.

Voir aussi StyleHint, styleHint(), StyleStrategy, styleStrategy() et QFontInfo.

void QFont::setStyleStrategy ( StyleStrategy s )

D�finit la strat�gie de style pour la fonte � s.

Voir aussi styleStrategy() et QFont::StyleStrategy.

void QFont::setUnderline ( bool enable )

Si enable est d�fini � true, le soulignement est activ� ; sinon le soulignement est d�sactiv�.

Voir aussi underline() et QFontInfo.

void QFont::setWeight ( int weight )

D�finit la graisse de la fonte � weight, laquelle doit �tre une valeur de l'�num�ration QFont::Weight.

Voir aussi weight() et QFontInfo.

void QFont::setWordSpacing ( qreal spacing )

D�finit l'espacement des mots pour la fonte � spacing.

L'espacement des mots modifie l'espace par d�faut entre chaque mot. Une valeur positive augmente l'espacement entre les mots par le nombre de pixels correspondant, alors qu'une valeur n�gative diminue l'espacement entre les mots.

L'espacement entre les mots ne sera pas appliqu� sur les syst�mes d'�criture o� les mots ne sont pas s�par�s par des espaces.

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi wordSpacing() et setLetterSpacing().

int QFont::stretch () const

Retourne le facteur d'�tirement de la fonte.

Voir aussi setStretch().

bool QFont::strikeOut () const

Retourne true si la fonte est barr�e ; sinon retourne false.

Voir aussi setStrikeOut().

Style QFont::style () const

Retourne le style de la fonte.

Voir aussi setStyle().

StyleHint QFont::styleHint () const

Retourne le StyleHint.

L'indication de style affecte l'algorithme de correspondance des fontes. Voir QFont::StyleHint pour conna�tre la liste des indications disponibles.

Voir aussi setStyleHint(), QFont::StyleStrategy et QFontInfo::styleHint().

StyleStrategy QFont::styleStrategy () const

Retourne la StyleStrategy.

La strat�gie de style affecte l'algorithme de correspondance des fontes. Voir QFont::StyleStrategy pour connaitre la liste des strat�gies disponibles.

Voir aussi setStyleStrategy(), setStyleHint() et QFont::StyleHint.

QString QFont::substitute ( const QString & familyName ) [static]

Retourne le premier nom de police de substitution � utiliser pour le nom familyName. La correspondance n'est pas sensible � la casse.

S'il n'y a pas de substitution pour familyName, familyName est retourn�.

Pour obtenir la liste des substitutions, utilisez la fonction substitutes().

Voir aussi setFamily(), insertSubstitutions(), insertSubstitution() et removeSubstitution().

QStringList QFont::substitutes ( const QString & familyName ) [static]

Retourne une liste des noms de police � utiliser pour le nom familyName. La correspondance n'est pas sensible � la casse.

S'il n'y a pas de substitution pour familyName, une liste vide est retourn�e.

Voir aussi substitute(), insertSubstitutions(), insertSubstitution() et removeSubstitution().

QStringList QFont::substitutions () [static]

Retourne une liste tri�e des noms de police de substitution.

Voir aussi insertSubstitution(), removeSubstitution() et substitute().

QString QFont::toString () const

Retourne une description de la fonte. La description est une liste d'attributs s�par�s par une virgule, parfaitement appropri�e pour une utilisation avec QSettings.

Voir aussi fromString().

bool QFont::underline () const

Retourne true si le soulignement est activ� ; sinon retourne false.

Voir aussi setUnderline().

int QFont::weight () const

Retourne la graisse de la fonte sous la forme d'une des valeurs de l'�num�ration QFont::Weight.

Voir aussi setWeight(), Weight et QFontInfo.

qreal QFont::wordSpacing () const

Retourne l'espacement des mots de la fonte.

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi setWordSpacing() et setLetterSpacing().

QFont::operator QVariant () const

Retourne la fonte sous la forme d'un QVariant

bool QFont::operator!= ( const QFont & f ) const

Retourne true si cette fonte est diff�rente de f ; sinon retourne false.

Deux QFonts sont consid�r�es comme diff�rentes si leurs attributs sont diff�rents. Si rawMode() est activ� pour les deux fontes, seuls les champs de la police sont compar�s.

Voir aussi operator==().

bool QFont::operator< ( const QFont & f ) const

Fournit une comparaison arbitraire de cette fonte avec f. Tout ce qui est garanti est que l'op�rateur retourne false si les deux fontes sont �gales et si (f1 < f2) == !(f2 < f1) si les fontes ne sont pas �gales.

Cette fonction est utile dans quelques cas, par exemple, si vous souhaitez utiliser des objets QFont comme cl�s dans une QMap.

Voir aussi operator==(), operator!=() et isCopyOf().

QFont & QFont::operator= ( const QFont & font )

Affecte la fonte font � cette fonte et retourne une r�f�rence sur celle-ci.

bool QFont::operator== ( const QFont & f ) const

Retourne true si cette fonte est �gale � f ; sinon retourne false.

Deux QFont sont consid�r�es comme �gales si leurs attributs sont �gaux. Si rawMode() est activ� pour les deux fontes, seuls les champs de la police sont compar�s.

Voir aussi operator!=() et isCopyOf().

En relation mais non membres de la classe

QDataStream & operator<< ( QDataStream & s, const QFont & font )

�crit la fonte font sur le flux s (toString() �crit un flux textuel).

Voir aussi Format des op�rateurs QDataStream.

QDataStream & operator>> ( QDataStream & s, QFont & font )

Lit la fonte font � partir du flux s (fromString() lit � partir d'un flux textuel).

Voir aussi Format des op�rateurs QDataStream.

Remerciements

Merci � Alexandre Laurent pour la traduction ainsi qu'� Ilya Diallo, Jonathan Courtois, Thibaut Cuvelier et Claude Leloup pour leur relecture !