Тип QML Диалог

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

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

Свойства

• footer : Элемент
• header : Элемент
• implicitFooterHeight : вещественное число
• implicitFooterWidth : вещественное число
• implicitHeaderHeight : вещественное число
• implicitHeaderWidth : вещественное число
• result : целое число
• standardButtons : перечисление
• title : строка

Сигналы

• accepted()
• applied()
• discarded()
• helpRequested()
• rejected()
• reset()

Методы

• void accept()
• void done(int result)
• void reject()
• AbstractButton standardButton(StandardButton button)

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

Диалоговое окно — это всплывающее окно, в основном используемое для краткосрочных задач и краткого общения с пользователем. Подобно ApplicationWindow и Page, диалог организован в три раздела: header, contentItem и footer.

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

Заголовок диалогового окна (title) отображается в строке заголовка, определенной стилем, которая по умолчанию назначается в качестве заголовка диалогового окна (header).

Стандартные кнопки диалогового окна управляются элементом DialogButtonBox, который по умолчанию назначается в качестве нижней части диалогового окна (footer). Свойство standardButtons диалогового окна передается соответствующему свойству элемента. Кроме того, сигналы accepted() и rejected() элемента подключаются к соответствующим сигналам в диалоговом окне.

Dialog {
    id: dialog
    title: "Title"
    standardButtons: Dialog.Ok | Dialog.Cancel

    onAccepted: console.log("Ok clicked")
    onRejected: console.log("Cancel clicked")
}

Модальные диалоговые окна

Модальное диалоговое окно (modal) блокирует ввод в другой контент под диалоговым окном. Когда открывается модальное диалоговое окно, пользователь должен завершить взаимодействие с диалоговым окном и закрыть его, прежде чем он сможет получить доступ к любому другому контенту в том же окне.

Dialog {
    id: dialog
    modal: true
    standardButtons: Dialog.Ok
}

Безмодальные диалоговые окна

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

Dialog {
    id: dialog
    modal: false
    standardButtons: Dialog.Ok
}

См. также DialogButtonBox и Popup Controls.

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

footer : Элемент

Это свойство содержит элемент нижней части диалогового окна. Элемент нижней части расположен внизу и имеет ширину диалогового окна. Значение по умолчанию — null.

Примечание: Назначение DialogButtonBox в качестве нижней части диалогового окна автоматически подключает его сигналы accepted() и rejected() к соответствующим сигналам в диалоговом окне.

Примечание: Назначение DialogButtonBox, ToolBar или TabBar в качестве нижней части диалогового окна автоматически устанавливает соответствующее свойство DialogButtonBox::position, ToolBar::position или TabBar::position в значение Footer.

См. также header.

header : Элемент

Это свойство содержит элемент заголовка диалогового окна. Элемент заголовка расположен вверху и имеет ширину диалогового окна. Значение по умолчанию — null.

Примечание: Назначение DialogButtonBox в качестве заголовка диалогового окна автоматически подключает его сигналы accepted() и rejected() к соответствующим сигналам в диалоговом окне.

Примечание: Назначение DialogButtonBox, ToolBar или TabBar в качестве заголовка диалогового окна автоматически устанавливает соответствующее свойство DialogButtonBox::position, ToolBar::position или TabBar::position в значение Header.

См. также footer.

[только чтение] implicitFooterHeight : вещественное число

Это свойство содержит неявную высоту нижней части.

Значение равно footer && footer.visible ? footer.implicitHeight : 0.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitFooterWidth и implicitHeaderHeight.

[только чтение] implicitFooterWidth : вещественное число

Это свойство содержит неявную ширину нижней части.

Значение равно footer && footer.visible ? footer.implicitWidth : 0.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitFooterHeight и implicitHeaderWidth.

[только чтение] implicitHeaderHeight : вещественное число

Это свойство содержит неявную высоту заголовка.

Значение равно header && header.visible ? header.implicitHeight : 0.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitHeaderWidth и implicitFooterHeight.

[только чтение] implicitHeaderWidth : вещественное число

Это свойство содержит неявную ширину заголовка.

Значение равно header && header.visible ? header.implicitWidth : 0.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitHeaderHeight и implicitFooterWidth.

result : целое число

Это свойство содержит код результата.

Стандартные коды результатов:

Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).

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

standardButtons : перечисление

Это свойство содержит комбинацию стандартных кнопок, используемых диалоговым окном.

Dialog {
    id: dialog
    title: "Title"
    standardButtons: Dialog.Ok | Dialog.Cancel

    onAccepted: console.log("Ok clicked")
    onRejected: console.log("Cancel clicked")
}

Кнопки будут размещены в соответствующем порядке для платформы пользователя.

Возможные флаги:

См. также DialogButtonBox.

title : строка

Это свойство содержит заголовок диалогового окна.

Заголовок отображается в заголовке диалогового окна.

Dialog {
    title: qsTr("About")

    Label {
        text: "Lorem ipsum..."
    }
}

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

accepted()

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

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

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

applied()

Этот сигнал испускается, когда нажата стандартная кнопка Dialog.Apply.

Этот сигнал был добавлен в QtQuick.Controls 2.3 (Qt 5.10).

См. также discarded() и reset().

discarded()

Этот сигнал испускается, когда нажата стандартная кнопка Dialog.Discard.

Этот сигнал был добавлен в QtQuick.Controls 2.3 (Qt 5.10).

См. также reset() и applied().

helpRequested()

Этот сигнал испускается, когда нажата стандартная кнопка Dialog.Help.

Этот сигнал был добавлен в QtQuick.Controls 2.3 (Qt 5.10).

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

rejected()

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

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

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

reset()

Этот сигнал испускается, когда нажата стандартная кнопка Dialog.Reset.

Этот сигнал был добавлен в QtQuick.Controls 2.3 (Qt 5.10).

См. также discarded() и applied().

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

пусто accept()

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

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

пусто done(целое result)

Закрывает диалоговое окно, устанавливает result и испускает accepted() или rejected(), в зависимости от того, является ли результат Dialog.Accepted или Dialog.Rejected соответственно.

Этот метод был добавлен в QtQuick.Controls 2.3 (Qt 5.10).

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

пусто reject()

Закрывает диалоговое окно и испускает сигнал rejected().

См. также accept() и done().

AbstractButton standardButton(StandardButton button)

Возвращает указанную стандартную кнопку button, или null если её нет.

Этот метод был добавлен в QtQuick.Controls 2.3 (Qt 5.10).

См. также standardButtons.