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
177
178
179
180
181
182
183
|
/* This file is part of the KDE project
* Copyright ( C ) 2007 Thorsten Zachmann <zachmann@kde.org>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library 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
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public License
* along with this library; see the file COPYING.LIB. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef KOPAVIEWMODE_H
#define KOPAVIEWMODE_H
#include "kopageapp_export.h"
#include <QObject>
#include <QPointF>
struct KoPageLayout;
class KoPAViewBase;
class KoPACanvas;
class KoPACanvasBase;
class KoPAPageBase;
class KoToolProxy;
class KoShape;
class KoViewConverter;
class QPainter;
class QPaintEvent;
class QTabletEvent;
class QMouseEvent;
class QKeyEvent;
class QWheelEvent;
class QCloseEvent;
class QRectF;
class KUndo2Command;
class KOPAGEAPP_EXPORT KoPAViewMode : public QObject
{
Q_OBJECT
public:
KoPAViewMode(KoPAViewBase * view, KoPACanvasBase * canvas, const QString& name = QString());
~KoPAViewMode() override;
virtual void paint(KoPACanvasBase* canvas, QPainter& painter, const QRectF &paintRect) = 0;
//virtual void paintEvent( KoPACanvas * canvas, QPaintEvent* event ) = 0;
virtual void tabletEvent( QTabletEvent *event, const QPointF &point ) = 0;
virtual void mousePressEvent( QMouseEvent *event, const QPointF &point ) = 0;
virtual void mouseDoubleClickEvent( QMouseEvent *event, const QPointF &point ) = 0;
virtual void mouseMoveEvent( QMouseEvent *event, const QPointF &point ) = 0;
virtual void mouseReleaseEvent( QMouseEvent *event, const QPointF &point ) = 0;
virtual void shortcutOverrideEvent( QKeyEvent *event ) = 0;
virtual void keyPressEvent( QKeyEvent *event ) = 0;
virtual void keyReleaseEvent( QKeyEvent *event ) = 0;
virtual void wheelEvent( QWheelEvent * event, const QPointF &point ) = 0;
/**
* The default implementation ignores this event
*/
virtual void closeEvent( QCloseEvent * event );
/**
* @brief Switch the active view mode to work on master/normal pages
*
* The default implementation does not change anything. If it is needed in the
* view mode you have to implement it.
*
* @param master if true work on master pages, if false work on normal pages
*/
virtual void setMasterMode( bool master );
/**
* @brief Check if the active view mode works on master/normal pages
*
* The default implementation always returns false
*
* @return false
*/
virtual bool masterMode();
/**
* @brief This method is called when the view mode is activated
*
* The default implementation does nothing.
*
* @param previousViewMode the view mode which was active before the
* activation of this view mode;
*/
virtual void activate( KoPAViewMode * previousViewMode );
/**
* @brief This method is called when the view mode is deactivated
*
* The default implementation does nothing.
*/
virtual void deactivate();
/**
* @brief Get the canvas
*
* @return canvas canvas used by the view mode
*/
KoPACanvasBase * canvas() const;
/**
* @brief Get the view
*
* @return view view used by the view mode
*/
KoPAViewBase * view() const;
/**
* @brief Get the view mode's implementation of view converter
*
* The default implementation returns the KoPAView's view converter
*
* @return the view converter used in the view mode
*/
virtual KoViewConverter * viewConverter( KoPACanvasBase * canvas );
virtual const KoPageLayout &activePageLayout() const;
virtual void changePageLayout( const KoPageLayout &pageLayout, bool applyToDocument, KUndo2Command *parent = 0 );
QPointF origin();
void setOrigin(const QPointF &origin);
void setName(const QString &name);
QString name() const;
public Q_SLOTS:
/**
* @brief Update the view when a new shape is added to the document
*
* The default implementation does nothing. The derived class' implementation
* should check whether the new shape is added to currently active page.
*
* @param shape the new shape added to the document
*/
virtual void addShape( KoShape *shape );
/**
* @brief Update the view when a shape is removed from the document
*
* The default implementation does nothing. The derived class' implementation
* should check whether the shape is removed from currently active page.
*
* @param shape the shape removed from the document
*/
virtual void removeShape( KoShape *shape );
/**
* @brief Update the view based on the active page
*
* The default implementation calls the KoPAView's updateActivePage(). If
* other behavior is intended when updating active page, the derived class
* should reimplement this function.
*
* @see KoPAView::updateActivePage()
*
* @param page the new page to be updated on the view mode
*/
virtual void updateActivePage(KoPAPageBase * page);
protected:
KoPACanvasBase * m_canvas;
KoToolProxy * m_toolProxy;
KoPAViewBase * m_view;
QPointF m_origin;
QString m_name;
};
#endif /* KOPAVIEWMODE_H */
|
