QFontDialog Class

Documentation sur les fonctions membres

[explicit] QFontDialog::QFontDialog(QWidget *parent = nullptr)

Construit une boîte de dialogue de police standard.

Utilisez setCurrentFont() pour définir les attributs initiaux de la police.

Le paramètre parent est transmis au constructeur QDialog.

Voir aussi getFont().

[explicit] QFontDialog::QFontDialog(const QFont &initial, QWidget *parent = nullptr)

Construit un dialogue de police standard avec la police donnée parent et la police spécifiée initial.

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

Réimplémente : QWidget::changeEvent(QEvent *event).

QFont QFontDialog::currentFont() const

Renvoie la police de caractères actuelle.

Voir aussi setCurrentFont() et selectedFont().

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

Ce signal est émis lorsque la police actuelle est modifiée. La nouvelle police est spécifiée dans font.

Ce signal est émis lorsque l'utilisateur sélectionne une police. En fin de compte, la police choisie peut être différente de la police actuellement sélectionnée.

Voir également currentFont, fontSelected() et selectedFont().

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

Réimplémente : QDialog::done(int r).

Ferme la boîte de dialogue et fixe son code de résultat à result. Si cette boîte de dialogue est affichée avec exec(), done() provoque la fin de la boucle d'événement locale et exec() renvoie result.

Voir également QDialog::done().

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

Ce signal est émis lorsqu'une police a été sélectionnée. La police sélectionnée est spécifiée dans font.

Ce signal n'est émis que lorsque l'utilisateur a choisi la police finale à utiliser. Il n'est pas émis lorsque l'utilisateur modifie la police actuelle dans la boîte de dialogue des polices.

Voir également selectedFont(), currentFontChanged() et currentFont.

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

Exécute une boîte de dialogue modale sur les polices et renvoie une police.

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

La boîte de dialogue est construite avec le paramètre parent et les options spécifiées dans options. title est affiché comme titre de la fenêtre de la boîte de dialogue et initial est la police initialement sélectionnée. Si le paramètre ok n'est pas nul, la valeur à laquelle il se réfère est définie comme vraie si l'utilisateur clique sur OK, et définie comme fausse si l'utilisateur clique sur Cancel.

Exemples :

bool ok;
QFont font = QFontDialog::getFont(&ok, QFont("Times", 12), this);
if (ok) {
    // font is set to the font the user selected
} else {
    // the user canceled the dialog; font is set to the initial
    // value, in this case Times, 12.
}

La boîte de dialogue peut également être utilisée pour définir 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 Annuler, la police originale sera utilisée.

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

Exécute une boîte de dialogue modale sur les polices et renvoie une police.

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

La boîte de dialogue est construite avec le paramètre parent. Si le paramètre ok n'est pas nul, la valeur à laquelle il se réfère est définie comme vraie si l'utilisateur clique sur OK, et fausse si l'utilisateur clique sur Cancel.

Exemple :

bool ok;
QFont font = QFontDialog::getFont(&ok, this);
if (ok) {
    // font is set to the font the user selected
} else {
    // the user canceled the dialog; font is set to the default
    // application font, QApplication::font()
}

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

Ouvre la boîte de dialogue et connecte son signal fontSelected() à l'emplacement spécifié par receiver et member.

Le signal sera déconnecté de l'emplacement lorsque la boîte de dialogue sera fermée.

QFont QFontDialog::selectedFont() const

Renvoie la police que l'utilisateur a sélectionnée en cliquant sur le bouton OK ou équivalent.

void QFontDialog::setCurrentFont(const QFont &font)

Définit la police de caractères mise en évidence dans le document QFontDialog à la valeur donnée font.

Voir aussi currentFont() et selectedFont().

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

Définit le site option comme étant activé si on est vrai ; sinon, efface le site option.

Voir aussi options et testOption().

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

Réimplémente : QDialog::setVisible(bool visible).

bool QFontDialog::testOption(QFontDialog::FontDialogOption option) const

Renvoie true si le site option est activé ; sinon, renvoie false.

Voir aussi options et setOption().