Obsolete Members for Dialog

The following members of QML type Dialog are obsolete. They are provided to keep old source code working. We strongly advise against using them in new code.

Properties

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 property was introduced in Ubuntu.Components 1.3.


contentWidth : real

Specifies the width of the dialog content.

This 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 property was introduced in Ubuntu.Components 1.3.

See also StyledItem::style.


styleName : string

The style name of the foreground of the Dialog.

This 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 property was introduced in Ubuntu.Components 1.3.

See also StyledItem::theme.


title : string

The title of the question to ask the user.