Spec-Zone.ru › Qt 5.15

Тип QML FontDialog

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

Заявление об импорте: import Qt.labs.platform 1.1
С тех пор: Qt 5.8
Наследует:

Dialog

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

Свойства

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

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

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

Чтобы отобразить диалог выбора шрифта, создайте экземпляр 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::setAttribute(Qt::AA_EnableHighDpiScaling);
    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 не обновляется во время выбора пользователем шрифтов в диалоге, а только после окончательного выбора. То есть, когда пользователь нажимает ОК для принятия шрифта. Кроме того, можно обработать сигнал accepted(), чтобы получить окончательный выбор.

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

options : флаги

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

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

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

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

Константа Описание
FontDialog.ScalableFonts Отобразить масштабируемые шрифты.
FontDialog.NonScalableFonts Отобразить не масштабируемые шрифты.
FontDialog.MonospacedFonts Отобразить шрифты с фиксированным размером.
FontDialog.ProportionalFonts Отобразить пропорциональные шрифты.
FontDialog.NoButtons Не отображать кнопки ОК и Отмена (полезно для «живых диалогов»).

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qml-qt-labs-platform-fontdialog.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API