Тип QML Диалог

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

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

Свойства

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

Сигналы

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

Методы

• void accept()
• void done(result)
• void reject()
• AbstractButton 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 и Управляющие элементы всплывающих окон.

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

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 : int

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

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

Это свойство было добавлено в 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().

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

void accept()

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

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

void done(result)

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

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

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

void reject()

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

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

AbstractButton standardButton(button)

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

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

См. также standardButtons.