Тип QML диалога
Базовый класс для диалоговых окон нативных платформ. Подробнее...
| Заявление об импорте: | import Qt.labs.platform 1.1 |
| С момента: | Qt 5.8 |
| Наследует от: | |
| Наследуется: | ColorDialog, FileDialog, FolderDialog, FontDialog и MessageDialog |
Свойства
- data : list<Object>
- flags : Qt::WindowFlags
- modality : Qt::WindowModality
- parentWindow : Window
- result : int
- title : string
- visible : bool
Сигналы
Методы
Подробное описание
Тип Dialog предоставляет общий API QML для диалоговых окон нативной платформы.
Для отображения нативного диалогового окна создайте экземпляр одного из конкретных реализаций Dialog, задайте необходимые свойства и вызовите open(). Dialog излучает accepted() или rejected(), когда пользователь закончит работу с диалоговым окном.
Примечание: Типы в модулях Qt.labs не гарантируют совместимость в будущих версиях.
Документация по свойствам
[default] data : список<Объект>
Это свойство по умолчанию содержит список всех объектов, объявленных как дочерние элементы диалогового окна.
flags : Qt::WindowFlags
Это свойство содержит флаги окна диалога. Значение по умолчанию — Qt.Dialog.
modality : Qt::WindowModality
Это свойство содержит модальный режим диалогового окна. Значение по умолчанию — Qt.WindowModal.
Доступные значения:
| Константа | Описание |
|---|---|
Qt.NonModal |
Диалоговое окно не модальное и не блокирует ввод в другие окна. |
Qt.WindowModal |
Диалоговое окно модальное для иерархии одного окна и блокирует ввод в его родительское окно, все окна-предки и все окна-родственники родительского и предкового окон. |
Qt.ApplicationModal |
Диалоговое окно модальное для приложения и блокирует ввод во все окна. |
parentWindow : Окно
Это свойство содержит родительское окно диалогового окна.
Если явно не задано, окно автоматически определяется путем итерации по родительским объектам QML до тех пор, пока не будет найдено окно Window или элемент Item, у которого есть окно.
result : int
Это свойство содержит код результата.
Стандартные коды результатов:
| Константа | Значение |
|---|---|
Dialog.Accepted | |
Dialog.Rejected |
Примечание: MessageDialog устанавливает результат в значение нажатой стандартной кнопки вместо использования стандартных кодов результатов.
title : строка
Это свойство содержит заголовок диалогового окна.
visible : bool
Это свойство содержит видимость диалогового окна. Значение по умолчанию — false.
Документация по сигналам
void accepted()
Этот сигнал излучается, когда диалоговое окно было принято либо интерактивно, либо путем вызова accept().
Примечание: Этот сигнал не излучается при закрытии диалогового окна с помощью close().
Примечание: Соответствующий обработчик — onAccepted.
См. также rejected().
void rejected()
Этот сигнал излучается, когда диалоговое окно было отклонено либо интерактивно, либо путем вызова reject().
Примечание: Этот сигнал не излучается при закрытии диалогового окна с помощью close().
Примечание: Соответствующий обработчик — onRejected.
См. также accepted().
Документация по методам
void accept()
Закрывает диалоговое окно и излучает сигнал accepted().
См. также reject().
void close()
Закрывает диалоговое окно.
void done(int result)
Закрывает диалоговое окно и устанавливает result.
См. также accept(), reject() и result.
void open()
Открывает диалоговое окно.
void reject()
Закрывает диалоговое окно и излучает сигнал rejected().
См. также accept().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qml-qt-labs-platform-dialog.html