1 |
|
|
/* |
2 |
|
|
* The ManaPlus Client |
3 |
|
|
* Copyright (C) 2011-2019 The ManaPlus Developers |
4 |
|
|
* Copyright (C) 2019-2021 Andrei Karas |
5 |
|
|
* |
6 |
|
|
* This file is part of The ManaPlus Client. |
7 |
|
|
* |
8 |
|
|
* This program is free software; you can redistribute it and/or modify |
9 |
|
|
* it under the terms of the GNU General Public License as published by |
10 |
|
|
* the Free Software Foundation; either version 2 of the License, or |
11 |
|
|
* any later version. |
12 |
|
|
* |
13 |
|
|
* This program is distributed in the hope that it will be useful, |
14 |
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of |
15 |
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
16 |
|
|
* GNU General Public License for more details. |
17 |
|
|
* |
18 |
|
|
* You should have received a copy of the GNU General Public License |
19 |
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>. |
20 |
|
|
*/ |
21 |
|
|
|
22 |
|
|
/* _______ __ __ __ ______ __ __ _______ __ __ |
23 |
|
|
* / _____/\ / /\ / /\ / /\ / ____/\ / /\ / /\ / ___ /\ / |\/ /\ |
24 |
|
|
* / /\____\// / // / // / // /\___\// /_// / // /\_/ / // , |/ / / |
25 |
|
|
* / / /__ / / // / // / // / / / ___ / // ___ / // /| ' / / |
26 |
|
|
* / /_// /\ / /_// / // / // /_/_ / / // / // /\_/ / // / | / / |
27 |
|
|
* /______/ //______/ //_/ //_____/\ /_/ //_/ //_/ //_/ //_/ /|_/ / |
28 |
|
|
* \______\/ \______\/ \_\/ \_____\/ \_\/ \_\/ \_\/ \_\/ \_\/ \_\/ |
29 |
|
|
* |
30 |
|
|
* Copyright (c) 2004 - 2008 Olof Naessén and Per Larsson |
31 |
|
|
* |
32 |
|
|
* |
33 |
|
|
* Per Larsson a.k.a finalman |
34 |
|
|
* Olof Naessén a.k.a jansem/yakslem |
35 |
|
|
* |
36 |
|
|
* Visit: http://guichan.sourceforge.net |
37 |
|
|
* |
38 |
|
|
* License: (BSD) |
39 |
|
|
* Redistribution and use in source and binary forms, with or without |
40 |
|
|
* modification, are permitted provided that the following conditions |
41 |
|
|
* are met: |
42 |
|
|
* 1. Redistributions of source code must retain the above copyright |
43 |
|
|
* notice, this list of conditions and the following disclaimer. |
44 |
|
|
* 2. Redistributions in binary form must reproduce the above copyright |
45 |
|
|
* notice, this list of conditions and the following disclaimer in |
46 |
|
|
* the documentation and/or other materials provided with the |
47 |
|
|
* distribution. |
48 |
|
|
* 3. Neither the name of Guichan nor the names of its contributors may |
49 |
|
|
* be used to endorse or promote products derived from this software |
50 |
|
|
* without specific prior written permission. |
51 |
|
|
* |
52 |
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
53 |
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
54 |
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
55 |
|
|
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
56 |
|
|
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
57 |
|
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED |
58 |
|
|
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR |
59 |
|
|
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF |
60 |
|
|
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING |
61 |
|
|
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS |
62 |
|
|
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
63 |
|
|
*/ |
64 |
|
|
|
65 |
|
|
#ifndef EVENTS_ACTIONEVENT_H |
66 |
|
|
#define EVENTS_ACTIONEVENT_H |
67 |
|
|
|
68 |
|
|
#include "events/event.h" |
69 |
|
|
|
70 |
|
|
#include <string> |
71 |
|
|
|
72 |
|
|
#include "localconsts.h" |
73 |
|
|
|
74 |
|
|
class Widget; |
75 |
|
|
|
76 |
|
|
/** |
77 |
|
|
* Represents an action event. An action event is an event |
78 |
|
|
* that can be fired by a widget whenever an action has occured. |
79 |
|
|
* What exactly an action is is up to the widget that fires |
80 |
|
|
* the action event. An example is a Button which fires an action |
81 |
|
|
* event as soon as the Button is clicked, another example is |
82 |
|
|
* TextField which fires an action event as soon as the enter |
83 |
|
|
* key is pressed. |
84 |
|
|
* |
85 |
|
|
* Any object can listen for actions from widgets by implementing |
86 |
|
|
* the ActionListener interface. |
87 |
|
|
* |
88 |
|
|
* If you have implement a widget of your own it's a good idea to |
89 |
|
|
* let the widget fire action events whenever you feel an action |
90 |
|
|
* has occured so action listeners of the widget can be informed |
91 |
|
|
* of the state of the widget. |
92 |
|
|
* |
93 |
|
|
* @see Widget::addActionListener, Widget::removeActionListener, |
94 |
|
|
* Widget::distributeActionEvent |
95 |
|
|
* @author Olof Naessén |
96 |
|
|
*/ |
97 |
|
2 |
class ActionEvent final : public Event |
98 |
|
|
{ |
99 |
|
|
public: |
100 |
|
|
/** |
101 |
|
|
* Constructor. |
102 |
|
|
* |
103 |
|
|
* @param source The source widget of the event. |
104 |
|
|
* @param id An identifier of the event. |
105 |
|
|
*/ |
106 |
|
1 |
ActionEvent(Widget *const source, const std::string &id) : |
107 |
|
|
Event(source), |
108 |
|
3 |
mId(id) |
109 |
|
|
{ |
110 |
|
|
} |
111 |
|
|
|
112 |
|
|
A_DELETE_COPY(ActionEvent) |
113 |
|
|
|
114 |
|
|
/** |
115 |
|
|
* Gets the identifier of the event. An identifier can |
116 |
|
|
* be used to distinguish from two actions from the same |
117 |
|
|
* widget or to let many widgets fire the same widgets |
118 |
|
|
* that should be treated equally. |
119 |
|
|
* |
120 |
|
|
* @return The identifier of the event. |
121 |
|
|
*/ |
122 |
|
|
const std::string &getId() const noexcept2 A_WARN_UNUSED |
123 |
|
1 |
{ return mId; } |
124 |
|
|
|
125 |
|
|
protected: |
126 |
|
|
/** |
127 |
|
|
* Holds the identifier of the event. |
128 |
|
|
*/ |
129 |
|
|
std::string mId; |
130 |
|
|
}; |
131 |
|
|
|
132 |
|
|
#endif // EVENTS_ACTIONEVENT_H |