En esta página

QFontDialog Class

La clase QFontDialog proporciona un control de diálogo para seleccionar una fuente. Más información...

Encabezado: #include <QFontDialog>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QDialog

Tipos públicos

enum FontDialogOption { NoButtons, DontUseNativeDialog, ScalableFonts, NonScalableFonts, MonospacedFonts, ProportionalFonts }
flags FontDialogOptions

Propiedades

Funciones públicas

QFontDialog(QWidget *parent = nullptr)
QFontDialog(const QFont &initial, QWidget *parent = nullptr)
QFont currentFont() const
void open(QObject *receiver, const char *member)
QFontDialog::FontDialogOptions options() const
QFont selectedFont() const
void setCurrentFont(const QFont &font)
void setOption(QFontDialog::FontDialogOption option, bool on = true)
void setOptions(QFontDialog::FontDialogOptions options)
bool testOption(QFontDialog::FontDialogOption option) const

Funciones públicas reimplementadas

virtual void setVisible(bool visible) override

Señales

void currentFontChanged(const QFont &font)
void fontSelected(const QFont &font)

Miembros públicos estáticos

QFont getFont(bool *ok, const QFont &initial, QWidget *parent = nullptr, const QString &title = QString(), QFontDialog::FontDialogOptions options = FontDialogOptions())
QFont getFont(bool *ok, QWidget *parent = nullptr)

Funciones protegidas reimplementadas

virtual void changeEvent(QEvent *e) override
virtual void done(int result) override

Descripción detallada

Se crea un cuadro de diálogo de fuentes mediante una de las funciones estáticas getFont().

Ejemplos:

bool ok;
QFont font = QFontDialog::getFont(
                &ok, QFont("Helvetica [Cronyx]", 10), this);
if (ok) {
    // the user clicked OK and font is set to the font the user selected
} else {
    // the user canceled the dialog; font is set to the initial
    // value, in this case Helvetica [Cronyx], 10
}

El cuadro de diálogo también se puede utilizar para establecer directamente la fuente de un widget:

myWidget.setFont(QFontDialog::getFont(0, myWidget.font()));

Si el usuario hace clic en «Aceptar», la fuente que haya elegido se utilizará para myWidget, y si hace clic en «Cancelar», se utilizará la fuente original.

Un cuadro de diálogo de fuentes con el estilo del widget Fusion.

Véase también « QFont» , « QFontInfo », « QFontMetrics », « QColorDialog », « QFileDialog » y «Ejemplo de cuadros de diálogo estándar».

Documentación sobre tipos de miembros

enum QFontDialog::FontDialogOption
flags QFontDialog::FontDialogOptions

Esta enumeración especifica diversas opciones que influyen en el aspecto y el comportamiento de un cuadro de diálogo de fuentes.

Por ejemplo, permite especificar qué tipo de fuente debe mostrarse. Si no se especifica ninguna, se mostrarán todas las fuentes disponibles.

Ten en cuenta que es posible que las opciones de filtrado de fuentes no sean compatibles con algunas plataformas (por ejemplo, Mac). Siempre son compatibles con el cuadro de diálogo no nativo (utilizado en Windows o Linux).

ConstanteValorDescripción
QFontDialog::NoButtons0x00000001No mostrar los botones « OK » y « Cancel ». (Útil para «diálogos en tiempo real»).
QFontDialog::DontUseNativeDialog0x00000002Utiliza el cuadro de diálogo de fuentes estándar de Qt en Mac en lugar del panel de fuentes nativo de Apple.
QFontDialog::ScalableFonts0x00000004Mostrar fuentes escalables
QFontDialog::NonScalableFonts0x00000008Mostrar fuentes no escalables
QFontDialog::MonospacedFonts0x00000010Mostrar fuentes monoespaciadas
QFontDialog::ProportionalFonts0x00000020Mostrar fuentes proporcionales

El tipo `FontDialogOptions` es un `typedef` para ` QFlags<FontDialogOption>`. Almacena una combinación OR de valores de `FontDialogOption`.

Véase también ` options`, ` setOption()` y ` testOption()`.

Documentación de la propiedad

currentFont : QFont

Esta propiedad contiene la fuente actual del cuadro de diálogo.

Funciones de acceso:

QFont currentFont() const
void setCurrentFont(const QFont &font)

Señal de notificación:

void currentFontChanged(const QFont &font)

options : FontDialogOptions

Esta propiedad contiene las distintas opciones que influyen en el aspecto y el comportamiento del cuadro de diálogo

Por defecto, todas las opciones están desactivadas.

Las opciones deben configurarse antes de mostrar el cuadro de diálogo. No se garantiza que configurarlas mientras el cuadro de diálogo está visible tenga un efecto inmediato en el mismo (dependiendo de la opción y de la plataforma).

Funciones de acceso:

QFontDialog::FontDialogOptions options() const
void setOptions(QFontDialog::FontDialogOptions options)

Véase también setOption() y testOption().

Documentación de funciones de miembro

[explicit] QFontDialog::QFontDialog(QWidget *parent = nullptr)

Crea un cuadro de diálogo estándar de fuentes.

Utiliza setCurrentFont() para establecer los atributos iniciales de la fuente.

El parámetro parent se pasa al constructor QDialog.

Véase también getFont().

[explicit] QFontDialog::QFontDialog(const QFont &initial, QWidget *parent = nullptr)

Crea un cuadro de diálogo de fuentes estándar con el nombre de fuente ( parent ) indicado y la fuente ( initial ) especificada.

[override virtual protected] void QFontDialog::changeEvent(QEvent *e)

Reimplementa: ` QWidget::changeEvent(QEvent *event)`.

QFont QFontDialog::currentFont() const

Devuelve la fuente actual.

Nota: Funcióngetter para la propiedad currentFont.

Véase también setCurrentFont() y selectedFont().

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

Esta señal se emite cuando se cambia la fuente actual. La nueva fuente se especifica en font.

La señal se emite mientras el usuario está seleccionando una fuente. Es posible que, al final, la fuente elegida difiera de la que está seleccionada en ese momento.

Nota: Señalde notificación para la propiedad currentFont.

Véase también currentFont, fontSelected() y selectedFont().

[override virtual protected] void QFontDialog::done(int result)

Reimplementa: QDialog::done(int r).

Cierra el cuadro de diálogo y establece su código de resultado en ` result`. Si este cuadro de diálogo se muestra con ` exec()`, la llamada a `done()` provoca que finalice el bucle de eventos local y que ` exec()` devuelva ` result`.

Véase también ` QDialog::done()`.

[signal] void QFontDialog::fontSelected(const QFont &font)

Esta señal se emite cuando se ha seleccionado una fuente. La fuente seleccionada se especifica en ` font`.

La señal solo se emite cuando el usuario ha elegido la fuente definitiva que se va a utilizar. No se emite mientras el usuario está cambiando la fuente actual en el cuadro de diálogo de fuentes.

Véase también selectedFont(), currentFontChanged() y currentFont.

[static] QFont QFontDialog::getFont(bool *ok, const QFont &initial, QWidget *parent = nullptr, const QString &title = QString(), QFontDialog::FontDialogOptions options = FontDialogOptions())

Abre un cuadro de diálogo modal de fuentes y devuelve una fuente.

Si el usuario hace clic en « OK », se devuelve la fuente seleccionada. Si el usuario hace clic en « Cancel », se devuelve la fuente « initial ».

El cuadro de diálogo se crea con el valor proporcionado en « parent » y las opciones especificadas en « options ». « title » aparece como título de la ventana del cuadro de diálogo y « initial » es la fuente seleccionada inicialmente. Si el parámetro « ok » no es nulo, el valor al que hace referencia se establece en «true» si el usuario hace clic en « OK », y en «false» si hace clic en « Cancel ».

Ejemplos:

bool ok;
QFont font = QFontDialog::getFont(&ok, QFont("Times", 12), this);
if (ok) {
    // font is set to the font the user selected
} else {
    // the user canceled the dialog; font is set to the initial
    // value, in this case Times, 12.
}

El cuadro de diálogo también se puede utilizar para establecer directamente la fuente de un widget:

myWidget.setFont(QFontDialog::getFont(0, myWidget.font()));

En este ejemplo, si el usuario hace clic en «Aceptar», se utilizará la fuente que haya elegido, y si hace clic en «Cancelar», se utilizará la fuente original.

[static] QFont QFontDialog::getFont(bool *ok, QWidget *parent = nullptr)

Abre un cuadro de diálogo modal de fuentes y devuelve una fuente.

Si el usuario hace clic en « OK », se devuelve la fuente seleccionada. Si el usuario hace clic en « Cancel », se devuelve la fuente predeterminada de Qt.

El cuadro de diálogo se crea con el valor proporcionado en ` parent`. Si el parámetro ` ok ` no es nulo, el valor al que hace referencia se establece en `true` si el usuario hace clic en ` OK`, y en `false` si hace clic en ` Cancel`.

Ejemplo:

bool ok;
QFont font = QFontDialog::getFont(&ok, this);
if (ok) {
    // font is set to the font the user selected
} else {
    // the user canceled the dialog; font is set to the default
    // application font, QApplication::font()
}

Esta es una función sobrecargada.

void QFontDialog::open(QObject *receiver, const char *member)

Abre el cuadro de diálogo y conecta su señal ` fontSelected()` a la ranura especificada por ` receiver ` y ` member`.

La señal se desconectará de la ranura cuando se cierre el cuadro de diálogo.

QFont QFontDialog::selectedFont() const

Devuelve la fuente que el usuario ha seleccionado al hacer clic en el botón « OK » o en un botón equivalente.

Nota: Esta fuente no siempre es la misma que la que contiene la propiedad « currentFont », ya que el usuario puede elegir diferentes fuentes antes de seleccionar finalmente la que va a utilizar.

void QFontDialog::setCurrentFont(const QFont &font)

Establece la fuente resaltada en « QFontDialog » en la especificada en « font ».

Nota: Funciónde asignación para la propiedad ` currentFont`.

Véase también currentFont() y selectedFont().

void QFontDialog::setOption(QFontDialog::FontDialogOption option, bool on = true)

Establece que el option especificado esté activado si on es verdadero; en caso contrario, desactiva el option especificado.

Véase también options y testOption().

[override virtual] void QFontDialog::setVisible(bool visible)

Reimplementa: ` QDialog::setVisible` (bool visible).

bool QFontDialog::testOption(QFontDialog::FontDialogOption option) const

Devuelve ` true ` si el ` option ` indicado está habilitado; en caso contrario, devuelve `false`.

Véase también options y setOption().

© 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.