FontDialog QML Type▲
-
Import Statement: import QtQuick.Dialogs 1.3
-
Since: Qt 5.2
-
Group: FontDialog is part of qtquick-visual, qtquickdialogs
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▲
[since 5.3] currentFont : font▲
The font which the user selected.
This property was introduced in Qt 5.3.
font : font▲
The font which the user selected and accepted.
modality : Qt::WindowModality▲
Whether the dialog should be shown modal with respect to the window containing the dialog's parent Item, modal with respect to the whole application, or non-modal.
By default it is Qt.NonModal.
Modality does not mean that there are any blocking calls to wait for the dialog to be accepted or rejected; it's only that the user will be prevented from interacting with the parent window and/or the application windows at the same time.
You probably need to write an onAccepted handler if you wish to change a font after the user has pressed the OK button, or an onCurrentFontChanged handler if you wish to react to every change the user makes while the dialog is open.
monospacedFonts : bool▲
Whether the dialog will show monospaced fonts or not.
nonScalableFonts : bool▲
Whether the dialog will show non scalable fonts or not.
proportionalFonts : bool▲
Whether the dialog will show proportional fonts or not.
scalableFonts : bool▲
Whether the dialog will show scalable fonts or not.
title : string▲
The title of the dialog window.