1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
/*
* Copyright (C) 2014 Canonical, Ltd.
*
* This program is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License version 3, as published by
* the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranties of MERCHANTABILITY,
* SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef DBUSUNITYSESSIONSERVICE_H
#define DBUSUNITYSESSIONSERVICE_H
#include <QDBusObjectPath>
#include "unitydbusobject.h"
typedef QList<QDBusObjectPath> QDbusList;
Q_DECLARE_METATYPE(QList<QDBusObjectPath>)
/**
* DBusUnitySessionService provides com.canonical.Unity.Session dbus
* interface.
*
* com.canonical.Unity.Session interface provides public methods
* and signals to handle Logout/Reboot/Shutdown.
*/
class DBusUnitySessionService : public UnityDBusObject
{
Q_OBJECT
Q_CLASSINFO("D-Bus Interface", "com.canonical.Unity.Session")
public:
DBusUnitySessionService();
~DBusUnitySessionService();
// For use in QML. Javascript doesn't accept functions beginning with capital letters
Q_INVOKABLE void logout() { Logout(); }
Q_INVOKABLE void reboot() { Reboot(); }
Q_INVOKABLE void shutdown() { Shutdown(); }
Q_INVOKABLE void endSession() { EndSession(); }
Q_SIGNALS:
/**
* logoutRequested signal
*
* This signal is emitted when some applications request the system to
* logout.
* @param have_inhibitors if there are any special running applications
* which inhibit the logout.
*/
Q_SCRIPTABLE void logoutRequested(bool have_inhibitors);
/**
* rebootRequested signal
*
* This signal is emitted when some applications request the system to
* reboot.
* @param have_inhibitors if there are any special running applications
* which inhibit the reboot.
*/
Q_SCRIPTABLE void rebootRequested(bool have_inhibitors);
/**
* shutdownRequested signal
*
* This signal is emitted when some applications request the system to
* shutdown.
* @param have_inhibitors if there are any special running applications
* which inhibit the shutdown.
*/
Q_SCRIPTABLE void shutdownRequested(bool have_inhibitors);
/**
* logoutReady signal
*
* This signal is emitted when all the apps are closed. And the system
* is safe to logout.
*/
void logoutReady();
public Q_SLOTS:
/**
* Logout the system.
*
* This method directly logout the system without user's confirmation.
* Ordinary applications should avoid calling this method. Please call
* RequestLogout() to ask the user to decide logout or not.
*/
Q_SCRIPTABLE void Logout();
/**
* Reboot the system.
*
* This method directly reboot the system without user's confirmation.
* Ordinary applications should avoid calling this method. Please call
* RequestReboot() to ask the user to decide reboot or not.
*/
Q_SCRIPTABLE void Reboot();
/**
* Shutdown the system.
*
* This method directly shutdown the system without user's confirmation.
* Ordinary applications should avoid calling this method. Please call
* RequestShutdown() to ask the user to decide shutdown or not.
*/
Q_SCRIPTABLE void Shutdown();
/**
* Issue a logout request.
*
* This method emit the logoutRequested signal to the shell with a boolean
* which indicates if there's any inhibitors. The shell should receive
* this signal and display a dialog to ask the user to confirm the logout
* action. If confirmed, shell can call Logout() method to logout.
*/
Q_SCRIPTABLE void RequestLogout();
/**
* Issue a reboot request.
*
* This method emit the rebootRequested signal to the shell with a boolean
* which indicates if there's any inhibitors. The shell should receive
* this signal and display a dialog to ask the user to confirm the reboot
* action. If confirmed, shell can call Reboot() method to reboot
*/
Q_SCRIPTABLE void RequestReboot();
/**
* Issue a shutdown request.
*
* This method emit the shutdownRequested signal to the shell with a
* boolean which indicates if there's any inhibitors.
* The shell should receive
* this signal and display a dialog to ask the user to confirm the reboot
* action. If confirmed, shell can call Shutdown() method to reboot
*/
Q_SCRIPTABLE void RequestShutdown();
/**
* Issue an EndSession request.
*
* This method calls the EndSession() Upstart DBus method on the
* current DBus session bus.
*/
Q_SCRIPTABLE void EndSession();
};
class DBusGnomeSessionManagerWrapper : public UnityDBusObject
{
Q_OBJECT
Q_CLASSINFO("D-Bus Interface", "org.gnome.SessionManager.EndSessionDialog")
public:
DBusGnomeSessionManagerWrapper();
~DBusGnomeSessionManagerWrapper();
public Q_SLOTS:
Q_SCRIPTABLE void Open(const unsigned int type, const unsigned int arg_1, const unsigned int max_wait, const QList<QDBusObjectPath> &inhibitors);
};
#endif // DBUSUNITYSESSIONSERVICE_H
|