Тип QML FontDialog
Диалог выбора шрифта. Подробнее...
| Оператор импорта: | import Qt.labs.platform |
| С момента: | Qt 5.8 |
| Наследует: |
Свойства
- 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 : флаги
Это свойство содержит различные параметры, которые влияют на внешний вид диалога.
По умолчанию все параметры отключены.
Параметры должны быть установлены перед отображением диалога. Установка их во время отображения диалога не гарантирует немедленного эффекта на диалог (в зависимости от параметра и платформы).
Доступные параметры:
| Постоянная | Описание |
|---|---|
FontDialog.ScalableFonts |
Показывать масштабируемые шрифты. |
FontDialog.NonScalableFonts |
Показывать не масштабируемые шрифты. |
FontDialog.MonospacedFonts |
Показывать шрифты с фиксированным интервалом. |
FontDialog.ProportionalFonts |
Показывать пропорциональные шрифты. |
FontDialog.NoButtons |
Не отображать кнопки OK и Отмена (полезно для «динамических диалогов»). |
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qml-qt-labs-platform-fontdialog.html