Тип QML Dialog
Базовый класс для диалоговых окон. Подробнее...
| Заявление об импорте: | import Qt.labs.platform |
| С: | Qt 5.8 |
| Наследует: | |
| Наследуется от: | ColorDialog, FileDialog, FolderDialog, FontDialog и MessageDialog |
Свойства
- data : list<QtObject>
- flags : Qt::WindowFlags
- modality : Qt::WindowModality
- parentWindow : Window
- result : int
- title : string
- visible : bool
Сигналы
Методы
Подробное описание
Тип Dialog предоставляет общий API QML для диалоговых окон нативных платформ.
Для отображения диалогового окна создайте экземпляр одного из конкретных реализаций Dialog, задайте необходимые свойства и вызовите open(). Диалоговое окно излучает accepted() или rejected(), когда пользователь закончил работу с диалоговым окном.
Примечание: Типы в модулях Qt.labs не гарантируют сохранения совместимости в будущих версиях.
Документация по свойствам
[default] data : list<QtObject>
Это свойство по умолчанию содержит список всех объектов, объявленных как дочерние элементы диалогового окна.
flags : Qt::WindowFlags
Это свойство содержит флаги окна диалогового окна. Значение по умолчанию — Qt.Dialog.
modality : Qt::WindowModality
Это свойство содержит модальность диалогового окна. Значение по умолчанию — Qt.WindowModal.
Доступные значения:
| Константа | Описание |
|---|---|
Qt.NonModal |
Диалоговое окно не является модальным и не блокирует ввод в другие окна. |
Qt.WindowModal |
Диалоговое окно является модальным для одной иерархии окон и блокирует ввод в родительское окно, все окна-прародители и все братья и сестры родительского и прародительского окон. |
Qt.ApplicationModal |
Диалоговое окно является модальным для приложения и блокирует ввод во все окна. |
parentWindow : Window
Это свойство содержит родительское окно диалогового окна.
Если не указано явно, окно автоматически определяется путем итерации QML-родительских объектов до тех пор, пока не будет найдено окно Window или элемент Item, у которого есть окно.
result : int
Это свойство содержит код результата.
Стандартные коды результатов:
| Константа | Значение |
|---|---|
Dialog.Accepted | |
Dialog.Rejected |
Примечание: MessageDialog устанавливает результат в значение нажатой стандартной кнопки вместо использования стандартных кодов результатов.
title : string
Это свойство содержит заголовок диалогового окна.
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.2/qml-qt-labs-platform-dialog.html