Sur cette page

FontDialog QML Type

Une boîte de dialogue de police native. Plus...

Import Statement: import Qt.labs.platform
Inherits:

Dialog

Status: Deprecated since 6.9

Ce type est obsolète depuis Qt Labs Platform 6.9. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Propriétés

Description détaillée

Utilisez plutôt QtQuick.Dialogs FontDialog.

Le type FontDialog fournit une API QML pour les boîtes de dialogue de police de la plate-forme native.

Un dialogue sur les polices de caractères natives

Pour afficher une boîte de dialogue de police, construisez une instance de FontDialog, définissez les propriétés souhaitées et appelez open(). La propriété currentFont peut être utilisée pour déterminer la police actuellement sélectionnée dans la boîte de dialogue. La propriété font n'est mise à jour qu'une fois la sélection finale effectuée en acceptant la boîte de dialogue.

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

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

MyDocument {
    id: document
    font: fontDialog.font
}

Disponibilité

Une boîte de dialogue pour les polices de la plate-forme native est actuellement disponible sur les plates-formes suivantes :

  • iOS
  • Linux (avec le thème de plateforme GTK+)
  • macOS

Le module Qt Labs Platform utilise Qt Widgets comme solution de repli sur les plateformes qui ne disposent pas d'une implémentation native. Par conséquent, les applications qui utilisent des types du module Qt Labs Platform doivent être liées à QtWidgets et utiliser QApplication au lieu de QGuiApplication.

Pour établir un lien avec la bibliothèque QtWidgets, ajoutez ce qui suit à votre fichier de projet qmake :

QT += widgets

Créez une instance de QApplication dans 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();
}

Note : La compatibilité des types dans les modules Qt.labs n'est pas garantie dans les versions futures.

Voir aussi QtQuick.Dialogs::FontDialog.

Documentation sur les propriétés

currentFont : font

Cette propriété contient la police actuellement sélectionnée dans la boîte de dialogue.

Contrairement à la propriété font, la propriété currentFont est mise à jour pendant que l'utilisateur sélectionne des polices dans la boîte de dialogue, même avant que la sélection finale n'ait été effectuée.

Voir également font.

font : font

Cette propriété contient la dernière police acceptée.

Contrairement à la propriété currentFont, la propriété font n'est pas mise à jour pendant que l'utilisateur sélectionne des polices dans la boîte de dialogue, mais seulement après la sélection finale. C'est-à-dire lorsque l'utilisateur a cliqué sur OK pour accepter une police. Il est également possible de gérer le signal accepted() pour obtenir la sélection finale.

Voir également currentFont et accepted().

options : flags

Cette propriété contient les différentes options qui affectent l'aspect et la convivialité de la boîte de dialogue.

Par défaut, toutes les options sont désactivées.

Les options doivent être définies avant d'afficher la boîte de dialogue. Le fait de les définir alors que la boîte de dialogue est visible ne garantit pas un effet immédiat sur la boîte de dialogue (en fonction de l'option et de la plate-forme).

Options disponibles :

ConstanteDescription
FontDialog.ScalableFontsAfficher les polices extensibles.
FontDialog.NonScalableFontsAfficher les polices non extensibles.
FontDialog.MonospacedFontsAfficher les polices monospaciales.
FontDialog.ProportionalFontsAffiche les polices proportionnelles.
FontDialog.NoButtonsNe pas afficher les boutons OK et Cancel (utile pour les "dialogues en direct").

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