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 |
- Lista de todos los miembros, incluidos los heredados
- QFontDialog forma parte de Diálogos estándar.
Tipos públicos
| enum | FontDialogOption { NoButtons, DontUseNativeDialog, ScalableFonts, NonScalableFonts, MonospacedFonts, ProportionalFonts } |
| flags | FontDialogOptions |
Propiedades
- currentFont : QFont
- options : FontDialogOptions
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.

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).
| Constante | Valor | Descripción |
|---|---|---|
QFontDialog::NoButtons | 0x00000001 | No mostrar los botones « OK » y « Cancel ». (Útil para «diálogos en tiempo real»). |
QFontDialog::DontUseNativeDialog | 0x00000002 | Utiliza el cuadro de diálogo de fuentes estándar de Qt en Mac en lugar del panel de fuentes nativo de Apple. |
QFontDialog::ScalableFonts | 0x00000004 | Mostrar fuentes escalables |
QFontDialog::NonScalableFonts | 0x00000008 | Mostrar fuentes no escalables |
QFontDialog::MonospacedFonts | 0x00000010 | Mostrar fuentes monoespaciadas |
QFontDialog::ProportionalFonts | 0x00000020 | Mostrar 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`.
© 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.