Тип 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.

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

footer : Элемент

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

См. также header.

header : Элемент

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

См. также 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().

Примечание: Соответствующий обработчик — 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().

Примечание: Соответствующий обработчик — 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.