Тип QML FontDialog

Компонент диалога для выбора шрифта. Подробнее...

• Список всех членов, включая наследуемые члены

Свойства

• currentFont : шрифт
• font : шрифт
• modality : Qt::WindowModality
• monospacedFonts : bool
• nonScalableFonts : bool
• proportionalFonts : bool
• scalableFonts : bool
• title : строка
• visible : bool

Методы

• void close()
• void open()

Подробное описание

FontDialog позволяет пользователю выбрать шрифт. Диалог изначально невидим. Сначала необходимо установить необходимые свойства, а затем установить visible в значение true или вызвать open().

Вот минимальный пример открытия диалога выбора шрифта и выхода после выбора пользователем шрифта:

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
}

Окно FontDialog автоматически является временным для родительского окна. Таким образом, независимо от того, объявляете ли вы диалог внутри Item или внутри Window, диалог будет отображаться по центру над окном, содержащим элемент, или над окном, которое вы объявили.

Реализация FontDialog будет диалогом платформенного выбора шрифта, если это возможно. Если это невозможно, то он попытается создать экземпляр QFontDialog. Если это тоже невозможно, то он вернётся к реализации QML, DefaultFontDialog.qml. В этом случае вы можете настроить внешний вид, отредактировав этот файл. DefaultFontDialog.qml содержит прямоугольник для хранения содержимого диалога, потому что некоторые встраиваемые системы не поддерживают несколько окон верхнего уровня. Когда диалог становится видимым, он автоматически будет обернут в окно, если это возможно, или просто переродится поверх основного окна, если может быть только одно окно.

Документация по свойствам

currentFont : font

Шрифт, выбранный пользователем.

Это свойство QML было введено в Qt 5.3.

font : font

Шрифт, выбранный и принятый пользователем.

modality : Qt::WindowModality

Определяет, должен ли диалог отображаться в модальном режиме относительно окна, содержащего родительский элемент диалога, модальном режиме относительно всего приложения или в немодальном режиме.

По умолчанию это Qt.NonModal.

Модальность не означает, что есть какие-либо блокирующие вызовы для ожидания принятия или отклонения диалога; она только препятствует взаимодействию пользователя с родительским окном и/или окнами приложения одновременно.

Вероятно, вам потребуется написать обработчик onAccepted, если вы хотите изменить шрифт после нажатия пользователем кнопки «ОК», или обработчик onCurrentFontChanged, если вы хотите отреагировать на каждое изменение, сделанное пользователем во время открытия диалога.

monospacedFonts : bool

Определяет, будут ли в диалоге отображаться шрифты с одинаковой шириной.

nonScalableFonts : bool

Определяет, будут ли в диалоге отображаться не масштабируемые шрифты.

proportionalFonts : bool

Определяет, будут ли в диалоге отображаться пропорциональные шрифты.

scalableFonts : bool

Определяет, будут ли в диалоге отображаться масштабируемые шрифты.

title : string

Заголовок окна диалога.

visible : bool

Это свойство определяет, виден ли диалог. По умолчанию оно равно false.

См. также modality.

Документация по методам

void close()

Закрывает диалог.

void open()

Отображает диалог пользователю. Это эквивалентно установке visible в значение true.