En esta página

FontDialog QML Type

Un cuadro de 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 de QML para los cuadros de diálogo de fuentes.

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

Para mostrar un cuadro de diálogo de fuentes, crea una instancia de `FontDialog`, configura las propiedades deseadas y llama a ` open()`. La propiedad ` currentFont ` se puede utilizar para determinar la fuente seleccionada actualmente en el cuadro de diálogo. La propiedad ` selectedFont ` solo se actualiza una vez que se ha realizado la selección definitiva al aceptar el cuadro de diálogo.

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

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

MyDocument {
    id: document
    font: fontDialog.selectedFont
}

Disponibilidad

Actualmente, el cuadro de diálogo de fuentes nativo de la plataforma está disponible en las siguientes plataformas:

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

Qt Quick Dialogs utiliza una implementación de « Qt Quick » como alternativa en aquellas plataformas que no dispongan de una implementación nativa.

Documentación de propiedades

options : flags

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

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

Las opciones deben configurarse antes de mostrar el cuadro de diálogo. No se garantiza que su configuración mientras el cuadro de diálogo está visible tenga un efecto inmediato en el mismo (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 «cuadros de diálogo en tiempo real»).
FontDialog.DontUseNativeDialogObliga al cuadro de diálogo a utilizar una implementación rápida no nativa.

selectedFont : font

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

La propiedad « selectedFont » se actualiza mientras el usuario selecciona fuentes en el cuadro de diálogo, incluso antes de que se haya realizado la selección definitiva.

La señal ` accepted()` puede gestionarse para obtener la selección final. Cuando el usuario ha hecho clic en « Select » (o « Open », dependiendo de la plataforma) para aceptar una fuente, un controlador de señales para la señal ` accepted()` puede consultar la propiedad `selectedFont` para obtener la fuente final 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.