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
|
/* -*- c-basic-offset: 4 indent-tabs-mode: nil -*- vi:set ts=8 sts=4 sw=4: */
/*
Rosegarden
A MIDI and audio sequencer and musical notation editor.
This program is Copyright 2000-2008
Guillaume Laurent <glaurent@telegraph-road.org>,
Chris Cannam <cannam@all-day-breakfast.com>,
Richard Bown <richard.bown@ferventsoftware.com>
The moral rights of Guillaume Laurent, Chris Cannam, and Richard
Bown to claim authorship of this work have been asserted.
Other copyrights also apply to some parts of this work. Please
see the AUTHORS file and individual file headers for details.
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; either version 2 of the
License, or (at your option) any later version. See the file
COPYING included with this distribution for more information.
*/
#ifndef _RG_EDITTOOL_H_
#define _RG_EDITTOOL_H_
#include "BaseTool.h"
#include <kxmlguiclient.h>
#include <qstring.h>
#include "base/Event.h"
class QMouseEvent;
namespace Rosegarden
{
class ViewElement;
class Event;
class EditView;
/**
* Edit tool base class.
*
* A EditTool represents one of the items on an edition view
* toolbar. It handles mouse click events for the EditView ('State'
* design pattern).
*
* A EditTool can have a menu, normally activated through a right
* mouse button click. This menu is defined in an XML file, see
* NoteInserter and noteinserter.rc for an example.
*
* This class is a "semi-singleton", that is, only one instance per
* EditView window is created. This is because menu creation is
* slow, and the fact that a tool can trigger the setting of another
* tool through a menu choice). This is maintained with the
* EditToolBox class This means we can't rely on the ctor/dtor to
* perform setting up, like mouse cursor changes for instance. Use the
* ready() and stow() method for this.
*
* @see EditView#setTool()
* @see EditToolBox
*/
class EditTool : public BaseTool, public KXMLGUIClient
{
friend class EditToolBox;
public:
/**
* Dispatch the event to Left/Middle/Right MousePress
*/
virtual void handleMousePress(timeT time,
int height,
int staffNo,
QMouseEvent *event,
ViewElement*);
/**
* Main operation of the tool
*/
virtual void handleLeftButtonPress(timeT time,
int height,
int staffNo,
QMouseEvent *event,
ViewElement*) = 0;
/**
* Do nothing
*/
virtual void handleMidButtonPress(timeT time,
int height,
int staffNo,
QMouseEvent*,
ViewElement*);
/**
* Show option menu
*/
virtual void handleRightButtonPress(timeT time,
int height,
int staffNo,
QMouseEvent*,
ViewElement*);
/**
* Do nothing
*/
virtual void handleMouseDoubleClick(timeT time,
int height,
int staffNo,
QMouseEvent*,
ViewElement*);
/**
* Do nothing.
* Implementations of handleMouseMove should return true if
* they want the canvas to scroll to the position the mouse
* moved to following the method's return.
*/
virtual int handleMouseMove(timeT time,
int height,
QMouseEvent*);
/**
* Do nothing
*/
virtual void handleMouseRelease(timeT time,
int height,
QMouseEvent*);
/**
* Respond to an event being deleted -- it may be the one the tool
* is remembering as the current event.
*/
virtual void handleEventRemoved(Event *) { }
protected:
/**
* Create a new EditTool
*
* \a menuName : the name of the menu defined in the XML rc file
*/
EditTool(const QString& menuName, EditView*);
void setRCFileName(QString rcfilename) { m_rcFileName = rcfilename; }
virtual void createMenu();
virtual void createMenu(QString rcFileName);
virtual bool hasMenu();
//--------------- Data members ---------------------------------
QString m_rcFileName;
EditView* m_parentView;
};
}
#endif
|
