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
170
171
172
173
174
175
176
|
/*
* Copyright (C) 2016-2017 Canonical Ltd.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; version 3.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef LOMIRI_WINDOW_H
#define LOMIRI_WINDOW_H
#include <QLoggingCategory>
#include <QObject>
#include <QPoint>
// Lomiri API
#include <lomiri/shell/application/Mir.h>
#include "WindowManagerGlobal.h"
namespace lomiri {
namespace shell {
namespace application {
class MirSurfaceInterface;
}
}
}
Q_DECLARE_LOGGING_CATEGORY(LOMIRI_WINDOW)
/**
@brief A slightly higher concept than MirSurface
A Window exists before its MirSurface gets created (for splashscreen purposes)
and might also hang around after the backing surface is gone (In case the application
was killed to free up memory, as it should still remain in the window list since the user
did not explicitly close it).
*/
class WINDOWMANAGERQML_EXPORT Window : public QObject
{
Q_OBJECT
/**
* @brief Position of the current surface buffer, in pixels.
*/
Q_PROPERTY(QPoint position READ position NOTIFY positionChanged)
/**
* @brief Requested position of the current surface buffer, in pixels.
*/
Q_PROPERTY(QPoint requestedPosition READ requestedPosition WRITE setRequestedPosition NOTIFY requestedPositionChanged)
/**
* @brief State of the surface
*/
Q_PROPERTY(Mir::State state READ state NOTIFY stateChanged)
/**
* @brief Whether the surface is focused
*
* It will be true if this surface is MirFocusControllerInterface::focusedSurface
*/
Q_PROPERTY(bool focused READ focused NOTIFY focusedChanged)
/**
* @brief Whether the surface wants to confine the mouse pointer within its boundaries
*
* If true, the surface doesn't want the mouse pointer to leave its boundaries while it's focused.
*/
Q_PROPERTY(bool confinesMousePointer READ confinesMousePointer NOTIFY confinesMousePointerChanged)
/**
* @brief A unique identifier for this window.
* Useful for telling windows apart in a list model as they get moved around
*/
Q_PROPERTY(int id READ id CONSTANT)
/**
* @brief Surface backing up this window
* It might be null if a surface hasn't been created yet (application is starting up) or if
* the corresponding application has been killed (but can still get restarted to continue from
* where it left)
*/
Q_PROPERTY(lomiri::shell::application::MirSurfaceInterface* surface READ surface NOTIFY surfaceChanged)
/**
* @brief Whether to comply to resize requests coming from the client side
*
* It's true by default
*/
Q_PROPERTY(bool allowClientResize READ allowClientResize WRITE setAllowClientResize NOTIFY allowClientResizeChanged)
public:
Window(int id, QObject *parent = nullptr);
virtual ~Window();
QPoint position() const;
QPoint requestedPosition() const;
void setRequestedPosition(const QPoint &);
Mir::State state() const;
bool focused() const;
bool confinesMousePointer() const;
int id() const;
lomiri::shell::application::MirSurfaceInterface* surface() const;
void setSurface(lomiri::shell::application::MirSurfaceInterface *surface);
void setFocused(bool value);
bool allowClientResize() const;
void setAllowClientResize(bool);
QString toString() const;
public Q_SLOTS:
/**
* @brief Requests a change to the specified state
*/
void requestState(Mir::State state);
/**
* @brief Sends a close request
*
*/
void close();
/**
* @brief Focuses and raises the window
*/
void activate();
Q_SIGNALS:
void closeRequested();
void emptyWindowActivated();
void positionChanged(QPoint position);
void requestedPositionChanged(QPoint position);
void stateChanged(Mir::State value);
void focusedChanged(bool value);
void confinesMousePointerChanged(bool value);
void surfaceChanged(lomiri::shell::application::MirSurfaceInterface *surface);
void allowClientResizeChanged(bool value);
void liveChanged(bool value);
/**
* @brief Emitted when focus for this window is requested by an external party
*/
void focusRequested();
private:
void updatePosition();
void updateState();
void updateFocused();
QPoint m_position;
QPoint m_requestedPosition;
bool m_positionRequested{false};
bool m_focused{false};
int m_id;
Mir::State m_state{Mir::RestoredState};
bool m_stateRequested{false};
lomiri::shell::application::MirSurfaceInterface *m_surface{nullptr};
bool m_allowClientResize{true};
};
QDebug operator<<(QDebug dbg, const Window *window);
Q_DECLARE_METATYPE(Window*)
#endif // LOMIRI_WINDOW_H
|
