En esta página

FontDialog QML Type

Un diálogo de fuentes nativo. 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. Desaconsejamos su uso en código nuevo.

Propiedades

Descripción detallada

Utilice QtQuick.Dialogs FontDialog en su lugar.

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

Diálogo de fuentes nativas

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

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

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

Para enlazar con la biblioteca QtWidgets, añada lo siguiente al archivo de proyecto qmake:

QT += widgets

Crear 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 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 actualmente seleccionada en el diálogo.

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

Véase también font.

font : font

Esta propiedad contiene la fuente final aceptada.

A diferencia de la propiedad currentFont, la propiedad font no se actualiza mientras el usuario está seleccionando fuentes en el diálogo, sino sólo después de haber hecho la selección final. Es decir, cuando el usuario ha pulsado OK para aceptar una fuente. Alternativamente, se puede manejar la señal accepted() para obtener la selección final.

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

options : flags

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

Por defecto, todas las opciones están desactivadas.

Las opciones deben establecerse antes de mostrar el diálogo. Establecerlas mientras el diálogo está visible no garantiza que tenga 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 OK y Cancel (útil para "diálogos en vivo").

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