FontDialog QML Type | Qt Quick Dialogs 5.9

Qt 5.9 | Qt Quick Dialogs | QML Types | FontDialog QML Type

Qt 5.9.2 Reference Documentation

# FontDialog QML Type

Dialog component for choosing a font. More...

Import Statement: | import QtQuick.Dialogs 1.2
Since: | Qt 5.2

- 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

currentFont : font

The font which the user selected.

This QML 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.

visible : bool

This property holds whether the dialog is visible. By default this is false.

See also modality.

## Method Documentation

void close()

Closes the dialog.

void open()

Shows the dialog to the user. It is equivalent to setting visible to true.