Тип 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() элемента DialogButtonBox подключаются к соответствующим сигналам в диалоговом окне.

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.

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitFooterHeight : вещественное число

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

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

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

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

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitFooterWidth : вещественное число

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

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

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

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

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitHeaderHeight : вещественное число

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

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

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

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

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitHeaderWidth : вещественное число

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

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

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

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

[начиная с QtQuick.Controls 2.3 (Qt 5.10)] 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.

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

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

[since QtQuick.Controls 2.3 (Qt 5.10)] applied()

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

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

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

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

[since QtQuick.Controls 2.3 (Qt 5.10)] discarded()

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

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

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

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

[since QtQuick.Controls 2.3 (Qt 5.10)] helpRequested()

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

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

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

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

rejected()

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

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

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

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

[since QtQuick.Controls 2.3 (Qt 5.10)] reset()

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

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

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

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

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

void accept()

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

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

[since QtQuick.Controls 2.3 (Qt 5.10)] void done(int result)

1. Устанавливает result.
2. Испускает accepted() или rejected(), в зависимости от того, является ли результат Dialog.Accepted или Dialog.Rejected соответственно.
3. Испускает closed().

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

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

void reject()

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

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

[since QtQuick.Controls 2.3 (Qt 5.10)] AbstractButton standardButton(StandardButton button)

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

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

См. также standardButtons.