QFontComboBox Class
El widget QFontComboBox es un combobox que permite al usuario seleccionar una familia de fuentes. Más...
| Cabecera: | #include <QFontComboBox> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | 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 combobox se rellena con una lista alfabetizada de nombres de familias de fuentes, como Arial, Helvetica y Times New Roman. Los nombres de las familias se muestran utilizando la fuente real cuando es posible. Para fuentes como Symbol, en las que el nombre no se puede representar en la propia fuente, se muestra una muestra de la fuente junto al nombre de la familia.
QFontComboBox se utiliza a menudo en las barras de herramientas, junto con un QComboBox para controlar el tamaño de la fuente y dos QToolButtons para negrita e itálica.
Cuando el usuario selecciona una nueva fuente, se emite la señal currentFontChanged() además de currentIndexChanged().
Llame a setWritingSystem() para indicar a QFontComboBox que muestre sólo fuentes que soporten un sistema de escritura determinado, y a setFontFilters() para filtrar ciertos tipos de fuentes como, por ejemplo, fuentes no escalables o fuentes monoespaciadas.
Véase también QComboBox, QFont, QFontInfo, QFontMetrics, y QFontDatabase.
Documentación de tipos de miembros
enum QFontComboBox::FontFilter
flags QFontComboBox::FontFilters
Este enum se puede utilizar para mostrar sólo ciertos 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 FontFilter.
Documentación de Propiedades
currentFont : QFont
Esta propiedad contiene la fuente actualmente seleccionada
Funciones de acceso:
| QFont | currentFont() const |
| void | setCurrentFont(const QFont &f) |
Señal del notificador:
| void | currentFontChanged(const QFont &font) |
Véase también currentIndex y currentText.
fontFilters : FontFilters
Esta propiedad contiene el filtro para el combobox
Por defecto, se muestran todos los tipos de letra.
Funciones de acceso:
| 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 sirve de filtro para el combobox
Si script es QFontDatabase::Any (por defecto), se listan todos los tipos de letra.
Funciones de acceso:
| QFontDatabase::WritingSystem | writingSystem() const |
| void | setWritingSystem(QFontDatabase::WritingSystem) |
Véase también fontFilters.
Documentación de las funciones miembro
[explicit] QFontComboBox::QFontComboBox(QWidget *parent = nullptr)
Construye un combobox de fuentes con la dirección parent.
[virtual noexcept] QFontComboBox::~QFontComboBox()
Destruye el combobox.
[signal] void QFontComboBox::currentFontChanged(const QFont &font)
Esta señal se emite cada vez que cambia la fuente actual, con la nueva font.
Nota: Señal notificadora 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 fontFamily dado (cuando el combo 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 muestra a mostrar después del nombre de la fuente (cuando el combo está abierto) para un fontFamily dado.
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 muestra a mostrar después del nombre de la fuente (cuando el combo está abierto) para un writingSystem dado.
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 font que se utilizará para mostrar un fontFamily dado (cuando el combo 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 sampleText a mostrar después del nombre de la fuente (cuando el combo está abierto) para un fontFamily dado.
El texto de muestra dado 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 sampleText a mostrar después del nombre de la fuente (cuando el combo está abierto) para un writingSystem dado.
El texto de muestra dado 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.
