]> git.mxchange.org Git - simgear.git/blob - simgear/canvas/events/CustomEvent.hxx
Canvas: support for custom events and event dispatching.
[simgear.git] / simgear / canvas / events / CustomEvent.hxx
1 ///@file Canvas user defined event
2 //
3 // Copyright (C) 2014  Thomas Geymayer <tomgey@gmail.com>
4 //
5 // This library is free software; you can redistribute it and/or
6 // modify it under the terms of the GNU Library General Public
7 // License as published by the Free Software Foundation; either
8 // version 2 of the License, or (at your option) any later version.
9 //
10 // This library is distributed in the hope that it will be useful,
11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13 // Library General Public License for more details.
14 //
15 // You should have received a copy of the GNU Library General Public
16 // License along with this library; if not, write to the Free Software
17 // Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301, USA
18
19 #ifndef CANVAS_CUSTOM_EVENT_HXX_
20 #define CANVAS_CUSTOM_EVENT_HXX_
21
22 #include <simgear/canvas/CanvasEvent.hxx>
23 #include <simgear/structure/map.hxx>
24
25 namespace simgear
26 {
27 namespace canvas
28 {
29
30   class CustomEvent:
31     public Event
32   {
33     public:
34
35       /**
36        *
37        * @param type_str    Event type name (if name does not exist yet it will
38        *                    be registered as new event type)
39        * @param data        Optional user data stored in event
40        */
41       CustomEvent( std::string const& type_str,
42                    StringMap const& data = StringMap() );
43
44       /**
45        *
46        * @param type_id     Event type id
47        * @param data        Optional user data stored in event
48        */
49       CustomEvent( int type_id,
50                    StringMap const& data = StringMap() );
51
52       /**
53        * Set user data
54        */
55       void setDetail(StringMap const& data);
56
57       /**
58        * Get user data
59        */
60       StringMap const& getDetail() const { return detail; }
61
62       virtual bool canBubble() const { return bubbles; }
63
64       StringMap detail; //<! user data map
65       bool bubbles;
66   };
67
68 } // namespace canvas
69 } // namespace simgear
70
71 #endif /* CANVAS_CUSTOM_EVENT_HXX_ */