En esta página

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

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.

Captura de pantalla de QFontComboBox en Windows Vista

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.

ConstanteValorDescripción
QFontComboBox::AllFonts0Mostrar todas las fuentes
QFontComboBox::ScalableFonts0x1Mostrar fuentes escalables
QFontComboBox::NonScalableFonts0x2Mostrar fuentes no escalables
QFontComboBox::MonospacedFonts0x4Mostrar fuentes monoespaciadas
QFontComboBox::ProportionalFonts0x8Mostrar 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.