Тип QML Dialog

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

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

Свойства

• footer : Элемент
• header : Элемент
• standardButtons : Перечисление
• title : Строка

Сигналы

• void accepted()
• void rejected()

Методы

• void accept()
• void reject()

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

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

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

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

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

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
}

Бесmodalные диалоговые окна

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

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.

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..."
    }
}

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

void accepted()

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

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

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

void rejected()

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

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

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

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

void accept()

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

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

void reject()

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

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