Spec-Zone.ru › Qt 6.1

Тип QML диалога

Базовый класс для диалоговых окон нативных платформ. Подробнее...

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

QtObject

Наследуется:

ColorDialog, FileDialog, FolderDialog, FontDialog и MessageDialog

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

Свойства

  • data : list<Object>
  • flags : Qt::WindowFlags
  • modality : Qt::WindowModality
  • parentWindow : Window
  • result : int
  • title : string
  • visible : bool

Сигналы

  • void accepted()
  • void rejected()

Методы

  • void accept()
  • void close()
  • void done(int result)
  • void open()
  • void reject()

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

Тип 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.

См. также open() и close().

Документация по сигналам

void accepted()

Этот сигнал излучается, когда диалоговое окно было принято либо интерактивно, либо путем вызова accept().

Примечание: Этот сигнал не излучается при закрытии диалогового окна с помощью close().

Примечание: Соответствующий обработчик — onAccepted.

См. также rejected().

void rejected()

Этот сигнал излучается, когда диалоговое окно было отклонено либо интерактивно, либо путем вызова reject().

Примечание: Этот сигнал не излучается при закрытии диалогового окна с помощью close().

Примечание: Соответствующий обработчик — onRejected.

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

Документация по методам

void accept()

Закрывает диалоговое окно и излучает сигнал accepted().

См. также reject().

void close()

Закрывает диалоговое окно.

См. также visible и open().

void done(int result)

Закрывает диалоговое окно и устанавливает result.

См. также accept(), reject() и result.

void open()

Открывает диалоговое окно.

См. также visible и close().

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

Spec-Zone.ru

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