Тип QML FontDialog

Диалог выбора шрифта. Подробнее...

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

Свойства

• currentFont : шрифт
• font : шрифт
• options : флаги

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

Тип FontDialog предоставляет QML API для диалогов выбора шрифтов нативной платформы.

Чтобы отобразить диалог выбора шрифта, создайте экземпляр FontDialog, задайте необходимые свойства и вызовите open(). Свойство currentFont может быть использовано для определения текущего выбранного шрифта в диалоге. Свойство font обновляется только после окончательного выбора, сделанного при принятии диалога.

MenuItem {
    text: "Font"
    onTriggered: fontDialog.open()
}

FontDialog {
    id: fontDialog
    currentFont.family: document.font
}

MyDocument {
    id: document
    font: fontDialog.font
}

Доступность

Диалог выбора шрифта нативной платформы в настоящее время доступен на следующих платформах:

• macOS
• Linux (при использовании темы платформы GTK+)

Модуль Qt Labs Platform использует Qt Widgets в качестве резервного варианта на платформах, на которых нет доступной нативной реализации. Поэтому приложения, использующие типы из модуля Qt Labs Platform, должны ссылаться на QtWidgets и использовать QApplication вместо QGuiApplication.

Чтобы связаться с библиотекой QtWidgets, добавьте следующее в файл проекта qmake:

QT += widgets

Создайте экземпляр QApplication в main():

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

Примечание: Типы в модулях Qt.labs не гарантируют сохранение совместимости в будущих версиях.

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

currentFont : шрифт

Это свойство содержит текущий выбранный шрифт в диалоге.

В отличие от свойства font, свойство currentFont обновляется, пока пользователь выбирает шрифты в диалоге, даже до принятия окончательного выбора.

См. также font.

font : шрифт

Это свойство содержит окончательно принятый шрифт.

В отличие от свойства currentFont, свойство font обновляется не в процессе выбора шрифтов пользователем, а только после принятия окончательного выбора. То есть, когда пользователь нажал OK, чтобы принять шрифт. В качестве альтернативы, можно обработать сигнал accepted() для получения окончательного выбора.

См. также currentFont и accepted().

options : флаги

Это свойство содержит различные параметры, которые влияют на внешний вид диалога.

По умолчанию все параметры отключены.

Параметры должны быть установлены до отображения диалога. Установка их во время видимости диалога не гарантирует немедленного воздействия на диалог (в зависимости от параметра и платформы).

Доступные параметры: