QFontComboBox Class

Le widget QFontComboBox est une liste déroulante qui permet à l'utilisateur de sélectionner une famille de polices. En savoir plus...

En-tête :	`#include <QFontComboBox>`

CMake :	`find_package(Qt6 REQUIRED COMPONENTS Widgets)` `target_link_libraries(mytarget PRIVATE Qt6::Widgets)`
qmake :	`QT += widgets`
Hérite de :	QComboBox

Liste de tous les membres, y compris les membres hérités

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

Slots 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 liste déroulante contient une liste classée par ordre alphabétique des noms de familles de polices, telles que Arial, Helvetica et Times New Roman. Les noms de familles sont affichés en utilisant la police correspondante lorsque cela est possible. Pour les polices telles que Symbol, dont le nom ne peut pas être représenté par 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 association avec un signal « QComboBox » permettant de contrôler la taille de la police et deux signaux « QToolButton» pour 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 indiquer à QFontComboBox de n’afficher que les polices prenant en charge un système d’écriture donné, et setFontFilters() pour filtrer certains types de polices, par exemple les polices non redimensionnables ou les polices à espacement fixe.

Capture d'écran de QFontComboBox sous Windows Vista

Voir également QComboBox, QFont, QFontInfo, QFontMetrics et QFontDatabase.

Documentation sur les types de membres

enum QFontComboBox::FontFilter
flags QFontComboBox::FontFilters

Cette énumération permet de 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 redimensionnables
`QFontComboBox::NonScalableFonts`	`0x2`	Afficher les polices non redimensionnables
`QFontComboBox::MonospacedFonts`	`0x4`	Afficher les polices à espacement fixe
`QFontComboBox::ProportionalFonts`	`0x8`	Afficher les polices proportionnelles

Le type FontFilters est une définition de type pour QFlags<FontFilter>. Il stocke une combinaison OR de valeurs FontFilter.

Documentation de la propriété

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 de notification :

void	currentFontChanged(const QFont &font)

Voir également currentIndex et currentText.

fontFilters : FontFilters

Cette propriété contient le filtre de la liste déroulante

Par défaut, toutes les polices sont répertoriées.

Fonctions d'accès :

QFontComboBox::FontFilters	fontFilters() const
void	setFontFilters(QFontComboBox::FontFilters filters)

Voir aussi writingSystem.

writingSystem : QFontDatabase::WritingSystem

Cette propriété définit le système d'écriture utilisé comme filtre pour la liste déroulante

Si la valeur « script » est définie sur « QFontDatabase::Any » (valeur par défaut), toutes les polices sont répertorié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)

Crée une liste déroulante de polices à partir de l'parent fournie.

`[virtual noexcept]` QFontComboBox::~QFontComboBox()

Supprime la liste déroulante.

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

Ce signal est émis chaque fois que la police actuelle change, avec la nouvelle font.

Remarque : signalde 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 une « fontFamily » donnée (lorsque la liste déroulante est ouverte).