Тип QML MessageDialog

Компонент диалога для отображения всплывающих сообщений. Подробнее...

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

Свойства

• clickedButton : StandardButton
• detailedText : строка
• icon : QQuickStandardIcon::Icon
• informativeText : строка
• modality : Qt::WindowModality
• standardButtons : StandardButtons
• text : строка
• title : строка
• visible : bool

Сигналы

• accepted()
• apply()
• discard()
• help()
• no()
• rejected()
• reset()
• yes()

Методы

• void close()
• void open()

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

Наиболее базовое использование MessageDialog — всплывающее предупреждение. Оно также позволяет пользователю реагировать различными способами в зависимости от включенных кнопок. Диалог изначально невидим. Сначала необходимо установить свойства по желанию, а затем установить visible в true или вызвать open().

Вот минимальный пример, чтобы показать предупреждение и выйти после того, как пользователь отреагирует:

import QtQuick 2.2
import QtQuick.Dialogs 1.1

MessageDialog {
    id: messageDialog
    title: "May I have your attention please"
    text: "It's so cool that you are using Qt Quick."
    onAccepted: {
        console.log("And of course you could only agree.")
        Qt.quit()
    }
    Component.onCompleted: visible = true
}

Существует несколько возможных обработчиков в зависимости от того, какие standardButtons имеет диалог и ButtonRole каждого. Например, обработчик onRejected будет вызван, если пользователь нажмёт кнопку Отмена, Закрыть или Прервать.

Окно MessageDialog автоматически является транзитным для своего родительского окна. Таким образом, независимо от того, объявляете ли вы диалог внутри Item или внутри Window, диалог будет отображаться по центру над окном, содержащим элемент, или над окном, которое вы объявили.

Реализация MessageDialog будет платформенным диалоговым окном сообщений, если это возможно. Если это невозможно, то она попытается создать экземпляр QMessageBox. Если и это невозможно, то она вернётся к QML-реализации, DefaultMessageDialog.qml. В этом случае вы можете настроить внешний вид, отредактировав этот файл. DefaultMessageDialog.qml содержит Rectangle для размещения содержимого диалога, потому что некоторые встроенные системы не поддерживают несколько окон верхнего уровня. Когда диалог становится видимым, он автоматически будет обернут в Window, если это возможно, или просто переродится поверх основного окна, если может быть только одно окно.

Документация по свойствам

clickedButton : StandardButton

Это свойство содержит кнопку, нажатую пользователем. Его значение — одно из флагов, установленных для свойства standardButtons.

detailedText : строка

Текст, отображаемый в области деталей, которая по умолчанию скрыта. Пользователь сможет нажать кнопку Показать подробности..., чтобы сделать её видимой.

См. также text.

icon : QQuickStandardIcon::Icon

Значок диалогового окна сообщения можно указать одним из этих значений:

нет значка	StandardIcon.NoIcon	Для незамысловатого предупреждения текста.
	StandardIcon.Question	Для вопроса во время нормальной работы.
	StandardIcon.Information	Для сообщения о нормальной работе.
	StandardIcon.Warning	Для сообщения о некритических ошибках.
	StandardIcon.Critical	Для сообщения о критических ошибках.

По умолчанию StandardIcon.NoIcon.

Значения перечисления такие же, как в QMessageBox::Icon.

informativeText : строка

Информативный текст, предоставляющий более подробное описание сообщения.

Информативный текст можно использовать для дополнения text, чтобы предоставить пользователю больше информации. В зависимости от платформы, он может отображаться в более мелком шрифте под текстом или просто добавляться к тексту.

См. также text.

modality : Qt::WindowModality

Указывает, должен ли диалог отображаться в модальном режиме по отношению к окну, содержащему родительский элемент диалога, модальном режиме по отношению ко всему приложению или в немодальном режиме.

По умолчанию это Qt.WindowModal.

Модальность не означает, что есть какие-либо блокирующие вызовы ожидания подтверждения или отклонения диалога; она только предотвращает взаимодействие пользователя с родительским окном и/или окнами приложения до закрытия диалога.

standardButtons : StandardButtons

В MessageDialog есть строка кнопок в нижней части, каждая из которых имеет ButtonRole, определяющий, какой сигнал будет отправлен при нажатии кнопки. Вы также можете узнать, какая именно кнопка была нажата после того, как это произошло, через свойство clickedButton. Вы можете управлять доступными кнопками, устанавливая стандартные кнопки в комбинацию поразрядного ИЛИ следующих флагов:

Например, следующий диалог задаст вопрос с 5 возможными ответами:

import QtQuick 2.2
import QtQuick.Dialogs 1.1

MessageDialog {
    title: "Overwrite?"
    icon: StandardIcon.Question
    text: "file.txt already exists.  Replace?"
    detailedText: "To replace a file means that its existing contents will be lost. " +
        "The file that you are copying now will be copied over it instead."
    standardButtons: StandardButton.Yes | StandardButton.YesToAll |
        StandardButton.No | StandardButton.NoToAll | StandardButton.Abort
    Component.onCompleted: visible = true
    onYes: console.log("copied")
    onNo: console.log("didn't copy")
    onRejected: console.log("aborted")
}

По умолчанию StandardButton.Ok.

Значения перечисления совпадают со значениями в QMessageBox::StandardButtons.

text : строка

Основной текст, который будет отображён.

title : строка

Заголовок окна диалога.

visible : логическое

Это свойство указывает, отображается ли диалог. По умолчанию это false.

См. также modality.

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

accepted()

Этот сигнал излучается, когда пользователь нажал любую кнопку, имеющую AcceptRole: ОК, Открыть, Сохранить, Сохранить все, Повторить или Пропустить.

Соответствующий обработчик onAccepted.

apply()

Этот сигнал излучается, когда пользователь нажал кнопку Применить.

Соответствующий обработчик onApply.

discard()

Этот сигнал излучается, когда пользователь нажал кнопку Отменить.

Соответствующий обработчик onDiscard.

help()

Этот сигнал излучается, когда пользователь нажал кнопку Справка. В зависимости от платформы, диалог может не закрываться автоматически, потому что помощь, предоставляемая вашей программой, должна быть связана с текстом, отображаемым в этом диалоге, чтобы помочь пользователю принять решение. Однако на других платформах нельзя одновременно отобразить диалог и окно справки. Если вы хотите убедиться, что диалог закроется, вы можете установить visible в false в вашем обработчике.

Соответствующий обработчик onHelp.

no()

Этот сигнал излучается, когда пользователь нажал любую кнопку, имеющую NoRole: Нет или Нет для всех.

Соответствующий обработчик onNo.

rejected()

Этот сигнал излучается, когда пользователь закрыл диалог, закрыв окно диалога, нажав кнопку Отмена, Закрыть или Прервать в диалоге, или нажав кнопку возврата или клавишу Escape.

Соответствующий обработчик onRejected.

reset()

Этот сигнал излучается, когда пользователь нажал любую кнопку, имеющую ResetRole: Сбросить или Восстановить значения по умолчанию.

Соответствующий обработчик onReset.

yes()

Этот сигнал излучается, когда пользователь нажал любую кнопку, имеющую YesRole: Да или Да для всех.

Соответствующий обработчик onYes.

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

void close()

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

void open()

Отображает диалог пользователю. Эквивалентно установке visible в true.