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
|
/* This file is part of the KDE project
Copyright (C) 1998, 1999, 2000 Torben Weis <weis@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 HANDLER_H
#define HANDLER_H
#include <tqobject.h>
#include <KoDocumentChild.h>
class TQWMatrix;
class KoView;
class KoPartResizeHandlerPrivate;
class KoPartMoveHandlerPrivate;
/**
* @brief An abstract base class for event handlers.
*
* The idea of an event handler is that it is created for a
* certain purpose, for example moving or resizing of a part.
* Once that action is finished, the handler will destroy
* itself.
*
* This design pattern helps you to keep your event filters
* and your mousePressEvent, mouseMoveEvent etc. methods clean.
*/
class KOFFICECORE_EXPORT KoEventHandler : public TQObject
{
Q_OBJECT
public:
KoEventHandler( TQObject* target );
~KoEventHandler();
TQObject* target();
private:
TQObject* m_target;
};
/**
* Used by @ref KoContainerHandler internally to handle resizing of
* embedded documents.
*/
class KoPartResizeHandler : public KoEventHandler
{
Q_OBJECT
public:
KoPartResizeHandler( TQWidget* widget, const TQWMatrix& matrix, KoView* view, KoChild* child,
KoChild::Gadget gadget, const TQPoint& point );
~KoPartResizeHandler();
protected:
void repaint(TQRegion &rgn);
bool eventFilter( TQObject*, TQEvent* );
private:
KoPartResizeHandlerPrivate *d;
};
/**
* Used by @ref KoContainerHandler internally to handle moving of
* embedded documents.
*/
class KoPartMoveHandler : public KoEventHandler
{
Q_OBJECT
public:
KoPartMoveHandler( TQWidget* widget, const TQWMatrix& matrix, KoView* view, KoChild* child,
const TQPoint& point );
~KoPartMoveHandler();
protected:
bool eventFilter( TQObject*, TQEvent* );
private:
KoPartMoveHandlerPrivate *d;
};
/**
* This class can handle moving and resizing of embedded
* documents in your class derived from @ref KoView.
*
* Just create one instance per view of this class and parts
* will magically be moved around on your document.
*
* This class acts like an event filter on your view, so the
* mouse events which are used for parts moving and resizing
* will never show up in your view.
*
* @see KoPartMoveHandlerPrivate
* @see KoPartResizeHandlerPrivate
*/
class KOFFICECORE_EXPORT KoContainerHandler : public KoEventHandler
{
Q_OBJECT
public:
KoContainerHandler( KoView* view, TQWidget* widget );
~KoContainerHandler();
signals:
/**
* Emitted if the user wants to open the popup menu for some
* child object.
*/
void popupMenu( KoChild*, const TQPoint& global_pos );
/**
* Emitted if the user pressed the delete key whilst a child was selected
*/
void deleteChild( KoChild* );
protected:
bool eventFilter( TQObject*, TQEvent* );
private:
/// This is a little helper function to get rid of some duplicated code
KoChild *child(KoChild::Gadget &gadget, TQPoint &pos, const TQMouseEvent *ev);
KoView* m_view;
};
#endif
|
