QFontDialog

La classe QFontDialog fournit une boîte de dialogue permettant de sélectionner une police. Plus d'informations...

 #include <QFontDialog>

Héritage

Hérite de QDialog.

Description détaillée

La classe QFontDialog fournit une boîte de dialogue permettant de sélectionner une police.

Une boîte de dialogue des polices est créée au travers d'une des méthodes statiques getFont().

Exemples :

 bool ok;
 QFont font = QFontDialog::getFont(
                 &ok, QFont("Helvetica [Cronyx]", 10), this);
 if (ok) {
     // l'utilisateur a cliqué sur OK : la police est fixée à celle choisie par l'utilisateur
 } else {
     // l'utilisateur a annulé la boîte de dialogue
     // la police est fixée à sa valeur initiale : dans ce cas Helvetica [Cronyx], 10
 }

La boîte de dialogue peut également être utilisée pour directement définir la police d'un widget :

 myWidget.setFont(QFontDialog::getFont(0, myWidget.font()));

Si l'utilisateur clique sur OK, la police qu'il a choisie sera utilisée pour myWidget ; s'il clique sur Cancel, ce sera la police originale.

Voir aussi QFont, QFontInfo, QFontMetrics, QColorDialog, QFileDialog, QPrintDialog et exemple de boîtes de dialogue standard.

Type

enum QFontDialog::FontDialogOptionflags QFontDialog::FontDialogOptions

Cette énumération spécifie les différentes options qui affectent l'apparence de la boîte de dialogue des polices.

Cette énumération a été introduite ou modifiée dans QT 4.5.

Le type FontDialogOptions est un typedef pour QFlags<FontDialogOption>. Il stocke une combinaison par OU logique de valeurs de FontDialogOption.

Voir aussi options, setOption() et testOption().

Propriétés

currentFont : QFont

Cette propriété contient la police courante de la boîte de dialogue.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

QFont currentFont () const

void setCurrentFont ( const QFont & font )

Notifier signal :

void currentFontChanged ( const QFont & font )

options : FontDialogOptions

Cette propriété contient les différentes options qui affectent l'apparence de la boîte de dialogue.

Par défaut, toutes les options sont désactivées.

Les options devraient être fixées avant d?afficher la boîte de dialogue. Il n?est pas certain d?obtenir un effet immédiat en modifiant les options alors que la boîte de dialogue est visible (cela dépend de l?option et de la plateforme).

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

FontDialogOptions options () const

void setOptions ( FontDialogOptions options )

Voir aussi setOption() et testOption().

Fonctions membres

QFontDialog::QFontDialog ( QWidget * parent = 0 )

Construit une boîte de dialogue standard des polices.

Utilisez setCurrentFont() pour fixer les attributs de la police initiale.

Le paramètre parent est passé au constructeur de QDialog.

Cette fonction a été introduite dans Qt 4.5.

Voir aussi getFont().

QFontDialog::QFontDialog ( const QFont & initial, QWidget * parent = 0 )

Construit une boîte de dialogue de polices avec le parent fourni et la police spécifiée par initial.

Cette fonction a été introduite dans Qt 4.5.

void QFontDialog::changeEvent ( QEvent * e ) [virtual protected]

Réimplémentation de QWidget::changeEvent().

void QFontDialog::currentFontChanged ( const QFont & font ) [signal]

Ce signal est émis lorsque la police courante change. La nouvelle police est spécifiée par font.

Ce signal est émis dès qu'un utilisateur sélectionne une police. En fin de compte, la police choisie peut différer de la police actuellement sélectionnée.

Cette fonction a été introduite dans Qt 4.5.

Voir aussi currentFont, fontSelected() et selectedFont().

void QFontDialog::done ( int result ) [virtual protected]

Réimplémentation de QDialog::done().

Ferme la boîte de dialogue et met son code de résultat dans result. Si cette boîte dialogue est affichée avec exec(), done() implique que la boucle d?événement se termine et que exec() retourne result.

Voir aussi QDialog::done().

void QFontDialog::fontSelected ( const QFont & font ) [signal]

Ce signal est émis dès qu'une police a été sélectionnée. La police sélectionnée est spécifiée par font.

Le signal est seulement émis quand un utilisateur a choisi la police finale à utiliser. Il n'est pas émis tant que l'utilisateur change la police courante dans la boîte de dialogue des polices.

Cette fonction a été introduite dans Qt 4.5.

Voir aussi selectedFont(), currentFontChanged() et currentFont.

QFont QFontDialog::getFont ( bool * ok, const QFont & initial, QWidget * parent, const QString & title, FontDialogOptions options ) [static]

Exécute une boîte de dialogue modale et retourne une police.

Si l'utilisateur clique sur OK, la police sélectionnée est retournée. Si l'utilisateur clique sur Cancel, la police initial est retournée.

La boîte de dialogue est construite avec le parent indiqué et les options spécifiées par options. title est affiché en tant que titre de la fenêtre et initial est la police initialement sélectionnée. Si le paramètre ok n'est pas n'est pas nul, la valeur qu'il pointe est mise à true si l'utilisateur clique sur OK, et à false si l'utilisateur clique sur Cancel.

Exemples :

 bool ok;
 QFont font = QFontDialog::getFont(&ok, QFont("Times", 12), this);
 if (ok) {
     // la police est fixée à celle choisie par l'utilisateur
 } else {
     // l'utilisateur a annulé la boîte de dialogue
     // la police est fixée à sa valeur initiale : dans ce cas Times, 12.
 }

La boîte de dialogue peut également être utilisée pour fixer directement la police d'un widget :

 myWidget.setFont(QFontDialog::getFont(0, myWidget.font()));

Dans cet exemple, si l'utilisateur clique sur OK, la police qu'il a choisie sera utilisée, et s'il clique sur Cancel, ce sera la police d'origine qui sera utilisée.

Attention : ne détruisez pas parent durant l'exécution de la boîte de dialogue. Si vous voulez le faire, vous devriez créer une boîte de dialogue vous-même en utilisant un des constructeurs de QFontDialog.

QFont QFontDialog::getFont ( bool * ok, const QFont & initial, QWidget * parent, const char * name ) [static]

Appelez getFont(ok, initial, parent) à la place.

Attention : ne détruisez pas parent durant l'exécution de la boîte de dialogue. Si vous voulez le faire, vous devriez créer une boîte de dialogue vous-même en utilisant un des constructeurs de QFontDialog.

Le paramètre name est ignoré.

Cette fonction a été introduite dans Qt 4.5.

QFont QFontDialog::getFont ( bool * ok, QWidget * parent, const char * name ) [static]

Appelez getFont(ok, parent) à la place.

Attention : ne détruisez pas parent durant l'exécution de la boîte de dialogue. Si vous voulez le faire, vous devriez créer une boîte de dialogue vous-même en utilisant un des constructeurs de QFontDialog.

Le paramètre name est ignoré.

QFont QFontDialog::getFont ( bool * ok, const QFont & initial, QWidget * parent, const QString & title ) [static]

Il s'agit d'une fonction surchargée.

Cette fonction a été introduite dans Qt 4.5.

QFont QFontDialog::getFont ( bool * ok, const QFont & initial, QWidget * parent = 0 ) [static]

Il s'agit d'une fonction surchargée.

QFont QFontDialog::getFont ( bool * ok, QWidget * parent = 0 ) [static]

Il s'agit d'une fonction surchargée.

Exécute une boîte de dialogue modale et retourne une police.

Si l'utilisateur clique sur OK, la police sélectionnée est retournée. Si l'utilisateur clique sur Cancel, la police par défaut de Qt est retournée.

Si le paramètre ok n?est pas n?est pas nul, la valeur qu?il pointe est mise à true si l?utilisateur clique sur OK, et à false si l?utilisateur clique sur Cancel.

Exemple :

 bool ok;
 QFont font = QFontDialog::getFont(&ok, this);
 if (ok) {
     // la police est fixée à celle choisie par l'utilisateur
 } else {
     // l'utilisateur a annulé la boîte de dialogue
     // la police est fixée à sa valeur initiale : QApplication::font()
 }

Attention : ne détruisez pas parent durant l'exécution de la boîte de dialogue. Si vous voulez le faire, vous devriez créer une boîte de dialogue vous-même en utilisant un des constructeurs de QFontDialog.

void QFontDialog::open ( QObject * receiver, const char * member )

Il s'agit d'une fonction surchargée.

Ouvre la boîte de dialogue et connecte son signal fontSelected() au slot spécifié par receiver et member.

Le signal sera déconnecté du slot quand la boîte de dialogue sera fermée.

Cette fonction a été introduite dans Qt 4.5.

QFont QFontDialog::selectedFont () const

Retourne la police que l'utilisateur a choisi en cliquant sur le bouton OK ou sur un bouton équivalent.

Note : Cette police n?est pas toujours la même que la police indiquée par la propriété currentFont puisque l?utilisateur peut choisir différentes polices avant de finalement sélectionner celle à utiliser.

void QFontDialog::setOption ( FontDialogOption option, bool on = true )

Si le paramètre on est égal à true, active l› option donnée; sinon, désactive l'option.

Voir aussi options et testOption().

void QFontDialog::setVisible ( bool visible ) [virtual]

Réimplémentation de QWidget::setVisible().

bool QFontDialog::testOption ( FontDialogOption option ) const

Retourne true si l› option donnée est activée; sinon retourne false.

Voir aussi options et setOption().

Remerciements

Merci à Dimitry Ernot pour la traduction, ainsi qu'à Lo?c Leguay et Claude Leloup pour la relecture !