Sur cette page

FontDialog QML Type

Un dialogue sur les polices de caractères. Plus d'informations...

Import Statement: import QtQuick.Dialogs
Since: Qt 6.2
Inherits:

Dialog

Propriétés

Description détaillée

Le type FontDialog fournit une API QML pour les boîtes de dialogue de polices de caractères.

L'utilisateur peut visualiser et sélectionner différentes polices de caractères via la boîte de dialogue des polices.

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é selectedFont 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.selectedFont
}

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

Qt Quick Dialogs utilise une implémentation Qt Quick comme solution de repli sur les plateformes qui n'ont pas d'implémentation native disponible.

Documentation sur les propriétés

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, aucune option n'est définie, ce qui signifie que tous les types de polices sont affichés et que la boîte de dialogue affiche les boutons standard Select et Cancel.

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 Open et Cancel (utile pour les "dialogues en direct").
FontDialog.DontUseNativeDialogForce la boîte de dialogue à utiliser une implémentation rapide non native.

selectedFont : font

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

La propriété selectedFont 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.

Le signal accepted() peut être traité pour obtenir la sélection finale. Lorsque l'utilisateur a cliqué sur Select (ou Open, selon la plate-forme) pour accepter une police, un gestionnaire de signal pour le signal accepted() peut interroger la propriété selectedFont pour obtenir la police finale sélectionnée par l'utilisateur.

Voir également currentFont et 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.