QFontComboBox Class
El widget QFontComboBox es un cuadro combinado que permite al usuario seleccionar una familia de fuentes. Más información...
| Encabezado: | #include <QFontComboBox> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QComboBox |
Tipos públicos
| enum | FontFilter { AllFonts, ScalableFonts, NonScalableFonts, MonospacedFonts, ProportionalFonts } |
| flags | FontFilters |
Propiedades
- currentFont : QFont
- fontFilters : FontFilters
- writingSystem : QFontDatabase::WritingSystem
Funciones públicas
| 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 |
Funciones públicas reimplementadas
| virtual QSize | sizeHint() const override |
Ranuras públicas
| void | setCurrentFont(const QFont &f) |
Señales
| void | currentFontChanged(const QFont &font) |
Funciones protegidas reimplementadas
| virtual bool | event(QEvent *e) override |
Descripción detallada
El cuadro combinado se rellena con una lista ordenada alfabéticamente de nombres de familias de fuentes, como Arial, Helvética y Times New Roman. Los nombres de las familias se muestran utilizando la fuente real siempre que sea posible. En el caso de fuentes como Symbol, cuyo nombre no puede representarse en la propia fuente, se muestra una muestra de la fuente junto al nombre de la familia.
QFontComboBox se utiliza a menudo en barras de herramientas, junto con un QComboBox para controlar el tamaño de la fuente y dos QToolButtonpara la negrita y la cursiva.
Cuando el usuario selecciona una nueva fuente, se emite la señal ` currentFontChanged()` además de ` currentIndexChanged()`.
Llama a ` setWritingSystem()` para indicar a `QFontComboBox` que muestre únicamente fuentes compatibles con un sistema de escritura determinado, y a ` setFontFilters()` para filtrar ciertos tipos de fuentes, como, por ejemplo, las fuentes no escalables o las fuentes monoespaciadas.

Véase también QComboBox, QFont, QFontInfo, QFontMetrics y QFontDatabase.
Documentación sobre tipos de miembros
enum QFontComboBox::FontFilter
flags QFontComboBox::FontFilters
Esta enumeración se puede utilizar para mostrar únicamente determinados tipos de fuentes en el cuadro combinado de fuentes.
| Constante | Valor | Descripción |
|---|---|---|
QFontComboBox::AllFonts | 0 | Mostrar todas las fuentes |
QFontComboBox::ScalableFonts | 0x1 | Mostrar fuentes escalables |
QFontComboBox::NonScalableFonts | 0x2 | Mostrar fuentes no escalables |
QFontComboBox::MonospacedFonts | 0x4 | Mostrar fuentes monoespaciadas |
QFontComboBox::ProportionalFonts | 0x8 | Mostrar fuentes proporcionales |
El tipo FontFilters es un typedef para QFlags<FontFilter>. Almacena una combinación OR de valores de FontFilter.
Documentación de la propiedad
currentFont : QFont
Esta propiedad contiene la fuente seleccionada actualmente
Funciones de acceso:
| QFont | currentFont() const |
| void | setCurrentFont(const QFont &f) |
Señal de notificación:
| void | currentFontChanged(const QFont &font) |
Véase también currentIndex y currentText.
fontFilters : FontFilters
Esta propiedad contiene el filtro del cuadro combinado
Por defecto, se muestran todas las fuentes.
Funciones de Access:
| QFontComboBox::FontFilters | fontFilters() const |
| void | setFontFilters(QFontComboBox::FontFilters filters) |
Véase también writingSystem.
writingSystem : QFontDatabase::WritingSystem
Esta propiedad contiene el sistema de escritura que actúa como filtro para el cuadro combinado
Si « script » es « QFontDatabase::Any » (valor predeterminado), se muestran todas las fuentes.
Funciones de Access:
| QFontDatabase::WritingSystem | writingSystem() const |
| void | setWritingSystem(QFontDatabase::WritingSystem) |
Véase también fontFilters.
Documentación de funciones de miembro
[explicit] QFontComboBox::QFontComboBox(QWidget *parent = nullptr)
Crea un cuadro combinado de fuentes con la fuente especificada parent.
[virtual noexcept] QFontComboBox::~QFontComboBox()
Elimina el cuadro combinado.
[signal] void QFontComboBox::currentFontChanged(const QFont &font)
Esta señal se emite cada vez que cambia la fuente actual, con el nuevo valor de « font ».
Nota: Señalde notificación para la propiedad currentFont.
Véase también currentFont.
[since 6.3] std::optional<QFont> QFontComboBox::displayFont(const QString &fontFamily) const
Devuelve la fuente (si está configurada) que se utilizará para mostrar un elemento « fontFamily » determinado (cuando el cuadro combinado está abierto).
Esta función se introdujo en Qt 6.3.
Véase también ` setDisplayFont()`.
[override virtual protected] bool QFontComboBox::event(QEvent *e)
Reimplementa: ` QComboBox::event(QEvent *event)`.
[since 6.3] QString QFontComboBox::sampleTextForFont(const QString &fontFamily) const
Devuelve el texto de ejemplo que se mostrará tras el nombre de la fuente (cuando el cuadro combinado esté abierto) para un ` fontFamily` determinado.
Esta función se introdujo en Qt 6.3.
Véase también setSampleTextForFont().
[since 6.3] QString QFontComboBox::sampleTextForSystem(QFontDatabase::WritingSystem writingSystem) const
Devuelve el texto de ejemplo que se mostrará tras el nombre de la fuente (cuando el cuadro combinado esté abierto) para un « writingSystem » determinado.
Esta función se introdujo en Qt 6.3.
Véase también setSampleTextForSystem().
[since 6.3] void QFontComboBox::setDisplayFont(const QString &fontFamily, const QFont &font)
Establece el objeto « font » que se utilizará para mostrar un objeto « fontFamily » determinado (cuando el cuadro combinado esté abierto).
Esta función se introdujo en Qt 6.3.
Véase también displayFont().
[since 6.3] void QFontComboBox::setSampleTextForFont(const QString &fontFamily, const QString &sampleText)
Establece el texto de « sampleText » que se mostrará tras el nombre de la fuente (cuando el menú desplegable esté abierto) para un « fontFamily » determinado.
El texto de ejemplo proporcionado con esta función tiene prioridad sobre el establecido con setSampleTextForSystem().
Esta función se introdujo en Qt 6.3.
Véase también sampleTextForFont().
[since 6.3] void QFontComboBox::setSampleTextForSystem(QFontDatabase::WritingSystem writingSystem, const QString &sampleText)
Establece el texto « sampleText » para que aparezca después del nombre de la fuente (cuando el menú desplegable está abierto) para un « writingSystem » determinado.
El texto de ejemplo proporcionado con setSampleTextForFont() tiene prioridad.
Esta función se introdujo en Qt 6.3.
Véase también sampleTextForSystem().
[override virtual] QSize QFontComboBox::sizeHint() const
Reimplementa: ` 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.