Ubuntu.Components.Popups.Dialog

The Dialog caters for cases in which the application requires the user to determine between optional actions. The Dialog will interrupt the user flow and lock the view for further interaction before the user has selected a desired action. It can only be closed by selecting an optional action confirming or cancelling the operation. More...

Import Statement: import Ubuntu.Components.Popups 1.3
Inherits:

PopupBase

  • Obsolete members

Properties

Detailed Description

Example:

import QtQuick 2.4
import Ubuntu.Components 1.3
import Ubuntu.Components.Popups 1.3
Item {
width: units.gu(80)
height: units.gu(80)
Component {
id: dialog
Dialog {
id: dialogue
title: "Save file"
text: "Are you sure that you want to save this file?"
Button {
text: "cancel"
onClicked: PopupUtils.close(dialogue)
}
Button {
text: "overwrite previous version"
color: UbuntuColors.orange
onClicked: PopupUtils.close(dialogue)
}
Button {
text: "save a copy"
color: UbuntuColors.orange
onClicked: PopupUtils.close(dialogue)
}
}
}
Button {
anchors.centerIn: parent
id: saveButton
text: "save"
onClicked: PopupUtils.open(dialog)
}
}

Property Documentation

callerMargin : real

The property holds the margin from the dialog's caller. The property is themed.


contentHeight : real

Specifies the height of the dialog content.

This QML property was introduced in Ubuntu.Components 1.3.


contentWidth : real

Specifies the width of the dialog content.

This QML property was introduced in Ubuntu.Components 1.3.


[default] contents : list<Object>

Content will be put inside a column in the foreround of the Dialog.


edgeMargins : real

The property holds the margins from the dialog's dismissArea. The property is themed.


The property controls whether the dialog is modal or not. Modal dialogs block event propagation to items under dismissArea, when non-modal ones let these events passed to these items. In addition, non-modal dialogs do not dim the dismissArea.

The default value is true.


style : Component

The style of the foreground of the Dialog. This property takes precedence over styleName

This QML property was introduced in Ubuntu.Components 1.3.

See also StyledItem::style.


styleName : string

The style name of the foreground of the Dialog.

This QML property was introduced in Ubuntu.Components 1.3.

See also StyledItem::styleName.


text : string

The question to the user.


theme : ThemeSettings

Configure the theme of the Dialog foreground and all its subcomponents. Example:

import QtQuick 2.4
import Ubuntu.Components 1.3
import Ubuntu.Components.Popups 1.3
MainView {
width: units.gu(40)
height: units.gu(71)
// make sure the main theme is Ambiance
theme.name: "Ubuntu.Components.Themes.Ambiance"
Component {
id: dialogComponent
Dialog {
id: dialog
title: "Input dialog"
// the dialog and its children will use SuruDark
theme: ThemeSettings {
name: "Ubuntu.Components.Themes.SuruDark"
}
TextField {
placeholderText: "enter text"
}
Button {
text: "Close"
onClicked: PopupUtils.close(dialog)
}
}
}
Button {
text: "Open dialog"
onClicked: PopupUtils.open(dialogComponent)
}
}

This QML property was introduced in Ubuntu.Components 1.3.

See also StyledItem::theme.


title : string

The title of the question to ask the user.