FontDialog QML Type

Dialog component for choosing a font. More...

• List of all members, including inherited members

Properties

• currentFont : font
• font : font
• modality : Qt::WindowModality
• monospacedFonts : bool
• nonScalableFonts : bool
• proportionalFonts : bool
• scalableFonts : bool
• title : string
• visible : bool

Methods

• void close()
• void open()

Detailed Description

FontDialog allows the user to select a font. The dialog is initially invisible. You need to set the properties as desired first, then set visible to true or call open().

Here is a minimal example to open a font dialog and exit after the user chooses a font:

import QtQuick 2.2
import QtQuick.Dialogs 1.1

FontDialog {
    id: fontDialog
    title: "Please choose a font"
    font: Qt.font({ family: "Arial", pointSize: 24, weight: Font.Normal })
    onAccepted: {
        console.log("You chose: " + fontDialog.font)
        Qt.quit()
    }
    onRejected: {
        console.log("Canceled")
        Qt.quit()
    }
    Component.onCompleted: visible = true
}

A FontDialog window is automatically transient for its parent window. So whether you declare the dialog inside an Item or inside a Window, the dialog will appear centered over the window containing the item, or over the Window that you declared.

The implementation of FontDialog will be a platform font dialog if possible. If that isn't possible, then it will try to instantiate a QFontDialog. If that also isn't possible, then it will fall back to a QML implementation, DefaultFontDialog.qml. In that case you can customize the appearance by editing this file. DefaultFontDialog.qml contains a Rectangle to hold the dialog's contents, because certain embedded systems do not support multiple top-level windows. When the dialog becomes visible, it will automatically be wrapped in a Window if possible, or simply reparented on top of the main window if there can only be one window.

Property Documentation

Method Documentation