QFontDialog Class

Documentation des fonctions membres

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

Affiche une boîte de dialogue de police standard.

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

Le paramètre ` parent ` est transmis au constructeur ` QDialog `.

Voir également getFont().

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

Affiche une boîte de dialogue de police standard avec l'parent ion fournie et la police initial spécifiée.

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

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

QFont QFontDialog::currentFont() const

Renvoie la police actuelle.

Voir également 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`.

Le signal est émis pendant qu'un utilisateur sélectionne une police. Il se peut que la police choisie diffère finalement de celle qui est 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 définit son code de résultat sur ` result`. Si cette boîte de dialogue est affichée à l'aide de ` exec()`, la fonction `done()` provoque la fin de la boucle d'événements locale et le retour de ` exec()` avec le code ` 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`.

Le signal n'est émis que lorsque l'utilisateur a choisi la police définitive à utiliser. Il n'est pas émis pendant que 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())

Affiche une boîte de dialogue modale de sélection de police 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 créée à partir de l'parent fournie et des options spécifiées dans options. title s'affiche comme titre de la fenêtre de la boîte de dialogue et initial correspond à la police initialement sélectionnée. Si le paramètre ok n'est pas nul, la valeur à laquelle il fait référence est définie sur true si l'utilisateur clique sur OK, et sur false s'il 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 ; s’il clique sur Annuler, la police d’origine sera utilisée.

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

Affiche une boîte de dialogue modale de sélection de police 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 à partir du paramètre « parent » fourni. Si le paramètre « ok » n’est pas nul, la valeur à laquelle il fait référence est définie sur « true » si l’utilisateur clique sur « OK », et sur « false » s’il 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 relie son signal « fontSelected() » au slot spécifié par « receiver » et « member ».

Le signal sera déconnecté du slot 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 un bouton équivalent.

void QFontDialog::setCurrentFont(const QFont &font)

Définit la police mise en surbrillance dans l'QFontDialog sur celle indiquée par l'font.

Voir également currentFont() et selectedFont().

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

Active l'option spécifiée si on est vrai ; sinon, désactive l'option spécifiée.

Voir également 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 l'option spécifiée est activée ; sinon, renvoie « false ».

Voir également options et setOption().