← Back to branch summary

~ubuntu-branches/ubuntu/quantal/kde-runtime/quantal

« back to all changes in this revision

Viewing changes to plasma/declarativeimports/plasmacomponents/qml/Dialog.qml

  • Committer: Package Import Robot
  • Author(s): Philip Muškovac
  • Date: 2012-06-03 21:50:00 UTC
  • mto: This revision was merged to the branch mainline in revision 21.
  • Revision ID: package-import@ubuntu.com-20120603215000-vn7oarsq0ynrydj5
Tags: upstream-4.8.80
Import upstream version 4.8.80

Show diffs side-by-side

added added

removed removed

Lines of Context:
plasma/declarativeimports/plasmacomponents/qml/Dialog.qml
40
40
**
41
41
****************************************************************************/
42
42
 
 
43
/**Documented API
 
44
Inherits:
 
45
        Item
 
46
 
 
47
Imports:
 
48
        QtQuick 1.0
 
49
        org.kde.plasma.core
 
50
 
 
51
Description:
 
52
        Provides a top-level window for short-term tasks and brief interaction with the user.
 
53
        A dialog floats on the top layer of the application view, usually overlapping the area reserved for the application content. Normally, a dialog provides information and gives warnings to the user, or asks the user to answer a question or select an option.
 
54
 
 
55
Properties:
 
56
        list<Item> buttons:
 
57
        A list of items in the dialog's button area. For example, you can use Row or Button components but you can also use any number of components that are based on Item component.
 
58
 
 
59
        list<Item> content:
 
60
        A list of items in the dialog's content area. You can use any component that is based on Item. For example, you can use ListView, so that the user can select from a list of names.
 
61
 
 
62
        int status:
 
63
        Indicates the dialog's phase in its life cycle. The values are as follows:
 
64
            - DialogStatus.Opening - the dialog is opening
 
65
            - DialogStatus.Open - the dialog is open and visible to the user
 
66
            - DialogStatus.Closing - the dialog is closing
 
67
            - DialogStatus.Closed - the dialog is closed and not visible to the user
 
68
        The dialog's initial status is DialogStatus.Closed.
 
69
 
 
70
        list<Item> title:
 
71
        A list of items in the dialog's title area. You can use a Text component but also any number of components that are based on Item. For example, you can use Text and Image components.
 
72
 
 
73
        Item visualParent:
 
74
        The item that is dimmed when the dialog opens. By default the root parent object is visualParent.
 
75
 
 
76
Signals:
 
77
        accepted():
 
78
        This signal is emitted when the user accepts the dialog's request or the accept() method is called.
 
79
        See also rejected().
 
80
 
 
81
        clickedOutside(): This signal is emitted when the user taps in the area that is inside the dialog's visual parent area but outside the dialog's area. Normally the visual parent is the root object. In that case this signal is emitted if the user taps anywhere outside the dialog's area.
 
82
        See also visualParent.
 
83
 
 
84
        rejected():
 
85
        This signal is emitted when the user rejects the dialog's request or the reject() method is called.
 
86
        See also accepted().
 
87
 
 
88
Methods:
 
89
        void accept():
 
90
        Accepts the dialog's request without any user interaction. The method emits the accepted() signal and closes the dialog.
 
91
        See also reject().
 
92
 
 
93
        void close():
 
94
        Closes the dialog without any user interaction.
 
95
 
 
96
        void open():
 
97
        Shows the dialog to the user.
 
98
 
 
99
        void reject():
 
100
        Rejects the dialog's request without any user interaction. The method emits the rejected() signal and closes the dialog.
 
101
        See also accept().
 
102
**/
 
103
 
43
104
import QtQuick 1.0
44
105
import org.kde.plasma.core 0.1 as PlasmaCore
45
 
import "AppManager.js" as Utils
 
106
import "private/AppManager.js" as Utils
46
107
import "." 0.1
47
108
 
48
109
Item {
64
125
 
65
126
    function open()
66
127
    {
67
 
        var pos = dialog.popupPosition(null, Qt.alignCenter)
 
128
        var pos = dialog.popupPosition(null, Qt.AlignCenter)
68
129
        dialog.x = pos.x
69
130
        dialog.y = pos.y
70
131