FontDialog QML Type

Boîte de dialogue relative aux polices natives. En savoir plus…

Ce type est obsolète depuis Qt Labs Platform 6.9. Nous déconseillons fortement de l'utiliser dans du nouveau code.

• Liste de tous les membres, y compris les membres hérités

Propriétés

• currentFont : font
• font : font
• options : flags

Description détaillée

Utilisez plutôt ` QtQuick.Dialogs FontDialog `.

Le type FontDialog fournit une API QML pour les boîtes de dialogue de polices natives de la plateforme.

Pour afficher une boîte de dialogue de polices, créez une instance de FontDialog, définissez les propriétés souhaitées, puis appelez la méthode open(). La propriété currentFont permet de 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, c’est-à-dire après avoir validé 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 de police native est actuellement disponible sur les plateformes suivantes :

• iOS
• Linux (lorsqu’il s’exécute avec le thème de la plateforme GTK+)
• macOS

Le module Qt Labs Platform utilise Qt Widgets comme solution de secours sur les plateformes ne disposant pas d’une implémentation native. Par conséquent, les applications utilisant des polices du module Qt Labs Platform doivent être liées à QtWidgets et utiliser QApplication à la place de QGuiApplication.

Pour lier votre application à 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();
}

Voir également 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 au fur et à mesure que l'utilisateur sélectionne des polices dans la boîte de dialogue, avant même que la sélection finale ne soit effectuée.

Voir également font.

font : font

Cette propriété contient la police finalement sélectionné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 uniquement une fois la sélection finale effectuée. Autrement dit, 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é regroupe les différentes options qui influent sur l'apparence et le comportement de la boîte de dialogue.

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

Les options doivent être définies avant l'affichage de la boîte de dialogue. Leur définition alors que la boîte de dialogue est visible ne garantit pas un effet immédiat sur celle-ci (selon l'option et la plateforme).

Options disponibles :