En esta página

FontDialog QML Type

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

Import Statement: import Qt.labs.platform
Inherits:

Dialog

Status: Deprecated since 6.9

Este tipo está obsoleto desde Qt Labs Platform 6.9. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

Descripción detallada

Utiliza en su lugar ` QtQuick.Dialogs FontDialog `.

El tipo `FontDialog` proporciona una API QML para los cuadros de diálogo de fuentes de la plataforma nativa.

Un cuadro de diálogo de fuentes nativas

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 font 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.font
}

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

El módulo Qt Labs Platform utiliza Qt Widgets como alternativa en aquellas plataformas que no dispongan de una implementación nativa. Por lo tanto, las aplicaciones que utilicen tipos del módulo Qt Labs Platform deben enlazarse con QtWidgets y utilizar QApplication en lugar de QGuiApplication.

Para vincularse a la biblioteca QtWidgets, añade lo siguiente a tu archivo de proyecto qmake:

QT += widgets

Crea una instancia de QApplication en main():

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

Nota: No se garantiza que los tipos de los módulos de Qt.labs sigan siendo compatibles en futuras versiones.

Véase también QtQuick.Dialogs::FontDialog.

Documentación de propiedades

currentFont : font

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

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

Véase también font.

font : font

Esta propiedad contiene la fuente aceptada finalmente.

A diferencia de la propiedad « currentFont », la propiedad « font » no se actualiza mientras el usuario está seleccionando fuentes en el cuadro de diálogo, sino solo después de que se haya realizado la selección definitiva. Es decir, cuando el usuario ha hecho clic en « OK » para aceptar una fuente. Como alternativa, se puede gestionar la señal « accepted()» para obtener la selección definitiva.

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

options : flags

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 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 « OK » y « Cancel » (útil para «cuadros de diálogo en tiempo real»).

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