En esta página

FontDialog QML Type

Un diálogo de fuentes. Más...

Import Statement: import QtQuick.Dialogs
Since: Qt 6.2
Inherits:

Dialog

Propiedades

Descripción detallada

El tipo FontDialog proporciona una API QML para diálogos de fuentes.

El usuario puede ver y seleccionar diferentes fuentes a través del cuadro de diálogo de fuentes

Para mostrar un diálogo de fuentes, construya una instancia de FontDialog, establezca las propiedades deseadas y llame a open(). La propiedad currentFont puede utilizarse para determinar la fuente actualmente seleccionada en el diálogo. La propiedad selectedFont se actualiza sólo después de que se haya hecho la selección final aceptando el diálogo.

MenuItem {
    text: "Font"
    onTriggered: fontDialog.open()
}

FontDialog {
    id: fontDialog
    currentFont.family: document.font
}

MyDocument {
    id: document
    font: fontDialog.selectedFont
}

Disponibilidad

El diálogo de fuentes de plataforma nativa está disponible actualmente en las siguientes plataformas:

  • iOS
  • Linux (cuando se ejecuta con el tema de plataforma GTK+)
  • macOS

Qt Quick Dialogs utiliza una implementación de Qt Quick como alternativa en plataformas que no disponen de una implementación nativa.

Documentación de propiedades

options : flags

Esta propiedad contiene las distintas opciones que afectan al aspecto del diálogo.

Por defecto, no se establece ninguna opción, lo que significa que se muestran todos los tipos de fuente y el diálogo muestra los botones estándar Select y Cancel.

Las opciones deben establecerse antes de mostrar el diálogo. Si se configuran mientras el diálogo está visible, no se garantiza que tengan un efecto inmediato en el diálogo (dependiendo de la opción y de la plataforma).

Opciones disponibles:

ConstanteDescripción
FontDialog.ScalableFontsMostrar fuentes escalables.
FontDialog.NonScalableFontsMostrar fuentes no escalables.
FontDialog.MonospacedFontsMostrar fuentes monoespaciadas.
FontDialog.ProportionalFontsMostrar fuentes proporcionales.
FontDialog.NoButtonsNo mostrar los botones Open y Cancel (útil para "diálogos en vivo").
FontDialog.DontUseNativeDialogObliga al diálogo a utilizar una implementación rápida no nativa.

selectedFont : font

Esta propiedad contiene la fuente actualmente seleccionada en el diálogo.

La propiedad selectedFont se actualiza mientras el usuario está seleccionando fuentes en el diálogo, incluso antes de que se haya realizado la selección final.

La señal accepted() puede ser manejada para obtener la selección final. Cuando el usuario ha pulsado Select (o Open, dependiendo de la plataforma) para aceptar una fuente, un manejador de señales para la señal accepted() puede consultar la propiedad selectedFont para obtener la fuente final que fue seleccionada por el usuario.

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

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