QFontComboBox Class
Le widget QFontComboBox est une boîte combinée qui permet à l'utilisateur de sélectionner une famille de polices. Plus d'informations...
| En-tête : | #include <QFontComboBox> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Héritages : | QComboBox |
Types publics
| enum | FontFilter { AllFonts, ScalableFonts, NonScalableFonts, MonospacedFonts, ProportionalFonts } |
| flags | FontFilters |
Propriétés
- currentFont : QFont
- fontFilters : FontFilters
- writingSystem : QFontDatabase::WritingSystem
Fonctions publiques
| QFontComboBox(QWidget *parent = nullptr) | |
| virtual | ~QFontComboBox() |
| QFont | currentFont() const |
(since 6.3) std::optional<QFont> | displayFont(const QString &fontFamily) const |
| QFontComboBox::FontFilters | fontFilters() const |
(since 6.3) QString | sampleTextForFont(const QString &fontFamily) const |
(since 6.3) QString | sampleTextForSystem(QFontDatabase::WritingSystem writingSystem) const |
(since 6.3) void | setDisplayFont(const QString &fontFamily, const QFont &font) |
| void | setFontFilters(QFontComboBox::FontFilters filters) |
(since 6.3) void | setSampleTextForFont(const QString &fontFamily, const QString &sampleText) |
(since 6.3) void | setSampleTextForSystem(QFontDatabase::WritingSystem writingSystem, const QString &sampleText) |
| void | setWritingSystem(QFontDatabase::WritingSystem) |
| QFontDatabase::WritingSystem | writingSystem() const |
Fonctions publiques réimplémentées
| virtual QSize | sizeHint() const override |
Emplacements publics
| void | setCurrentFont(const QFont &f) |
Signaux
| void | currentFontChanged(const QFont &font) |
Fonctions protégées réimplémentées
| virtual bool | event(QEvent *e) override |
Description détaillée
La boîte combobox est remplie par une liste alphabétique de noms de familles de polices, telles que Arial, Helvetica et Times New Roman. Les noms de famille sont affichés en utilisant la police réelle lorsque cela est possible. Pour les polices telles que Symbol, où le nom n'est pas représentable dans la police elle-même, un échantillon de la police est affiché à côté du nom de la famille.
QFontComboBox est souvent utilisé dans les barres d'outils, en conjonction avec un QComboBox pour contrôler la taille de la police et deux QToolButtonpour le gras et l'italique.
Lorsque l'utilisateur sélectionne une nouvelle police, le signal currentFontChanged() est émis en plus de currentIndexChanged().
Appelez setWritingSystem() pour demander à QFontComboBox de n'afficher que les polices compatibles avec un système d'écriture donné, et setFontFilters() pour filtrer certains types de polices, par exemple les polices non extensibles ou les polices monospaces.
Voir aussi QComboBox, QFont, QFontInfo, QFontMetrics, et QFontDatabase.
Documentation des types de membres
enum QFontComboBox::FontFilter
flags QFontComboBox::FontFilters
Cette énumération peut être utilisée pour n'afficher que certains types de polices dans la liste déroulante des polices.
| Constante | Valeur | Description |
|---|---|---|
QFontComboBox::AllFonts | 0 | Afficher toutes les polices |
QFontComboBox::ScalableFonts | 0x1 | Afficher les polices extensibles |
QFontComboBox::NonScalableFonts | 0x2 | Afficher les polices non extensibles |
QFontComboBox::MonospacedFonts | 0x4 | Afficher les polices monospaces |
QFontComboBox::ProportionalFonts | 0x8 | Afficher les polices proportionnelles |
Le type FontFilters est un typedef pour QFlags<FontFilter>. Il stocke une combinaison OU de valeurs FontFilter.
Documentation sur les propriétés
currentFont : QFont
Cette propriété contient la police actuellement sélectionnée
Fonctions d'accès :
| QFont | currentFont() const |
| void | setCurrentFont(const QFont &f) |
Signal du notificateur :
| void | currentFontChanged(const QFont &font) |
Voir aussi currentIndex et currentText.
fontFilters : FontFilters
Cette propriété contient le filtre pour le combobox
Par défaut, toutes les polices sont listées.
Fonctions d'accès :
| QFontComboBox::FontFilters | fontFilters() const |
| void | setFontFilters(QFontComboBox::FontFilters filters) |
Voir aussi writingSystem.
writingSystem : QFontDatabase::WritingSystem
Cette propriété contient le système d'écriture qui sert de filtre à la boîte combobox
Si script est QFontDatabase::Any (par défaut), toutes les polices sont listées.
Fonctions d'accès :
| QFontDatabase::WritingSystem | writingSystem() const |
| void | setWritingSystem(QFontDatabase::WritingSystem) |
Voir également fontFilters.
Documentation des fonctions membres
[explicit] QFontComboBox::QFontComboBox(QWidget *parent = nullptr)
Construit une boîte combobox avec la police donnée parent.
[virtual noexcept] QFontComboBox::~QFontComboBox()
Détruit le combobox.
[signal] void QFontComboBox::currentFontChanged(const QFont &font)
Ce signal est émis chaque fois que la police actuelle change, avec la nouvelle font.
Note : Signal de notification pour la propriété currentFont.
Voir également currentFont.
[since 6.3] std::optional<QFont> QFontComboBox::displayFont(const QString &fontFamily) const
Renvoie la police (si elle est définie) à utiliser pour afficher un site fontFamily donné (lorsque la liste déroulante est ouverte).
Cette fonction a été introduite dans Qt 6.3.
Voir aussi setDisplayFont().
[override virtual protected] bool QFontComboBox::event(QEvent *e)
Réimplémente : QComboBox::event(QEvent *event).
[since 6.3] QString QFontComboBox::sampleTextForFont(const QString &fontFamily) const
Renvoie l'échantillon de texte à afficher après le nom de la police (lorsque le combo est ouvert) pour un fontFamily donné.
Cette fonction a été introduite dans Qt 6.3.
Voir aussi setSampleTextForFont().
[since 6.3] QString QFontComboBox::sampleTextForSystem(QFontDatabase::WritingSystem writingSystem) const
Renvoie l'échantillon de texte à afficher après le nom de la police (lorsque le combo est ouvert) pour un writingSystem donné.
Cette fonction a été introduite dans Qt 6.3.
Voir aussi setSampleTextForSystem().
[since 6.3] void QFontComboBox::setDisplayFont(const QString &fontFamily, const QFont &font)
Définit le site font à utiliser pour afficher un site fontFamily donné (lorsque la liste déroulante est ouverte).
Cette fonction a été introduite dans Qt 6.3.
Voir aussi displayFont().
[since 6.3] void QFontComboBox::setSampleTextForFont(const QString &fontFamily, const QString &sampleText)
Définit le sampleText à afficher après le nom de la police (lorsque le combo est ouvert) pour un fontFamily donné.
L'exemple de texte donné avec cette fonction est prioritaire sur celui défini avec setSampleTextForSystem().
Cette fonction a été introduite dans Qt 6.3.
Voir aussi sampleTextForFont().
[since 6.3] void QFontComboBox::setSampleTextForSystem(QFontDatabase::WritingSystem writingSystem, const QString &sampleText)
Définit le sampleText à afficher après le nom de la police (lorsque le combo est ouvert) pour un writingSystem donné.
L'exemple de texte donné avec setSampleTextForFont() est prioritaire.
Cette fonction a été introduite dans Qt 6.3.
Voir aussi sampleTextForSystem().
[override virtual] QSize QFontComboBox::sizeHint() const
Réimplémente : QComboBox::sizeHint() const.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
