FontDialog QML Type

Une boîte de dialogue de polices. En savoir plus...

• Liste de tous les membres, y compris les membres hérités
• Membres obsolètes

Propriétés

• options : flags
• selectedFont : font

Description détaillée

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

Pour afficher une boîte de dialogue de police, 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é ` selectedFont ` 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.selectedFont
}

Disponibilité

Une boîte de dialogue de polices native est actuellement disponible sur les plateformes suivantes :

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

Qt Quick Dialogs utilise une implémentation Qt Quick comme solution de secours sur les plateformes ne disposant pas d'une implémentation native.

Documentation des propriétés

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, 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 présente les boutons standard « Select » et « Cancel ».

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 :

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, avant même que la sélection finale n'ait été effectuée.

Le signal ` accepted()` peut être géré 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` afin d'obtenir la police finale sélectionnée par l'utilisateur.

Voir également currentFont et accepted().