wesnoth/src/generic_event.hpp
Mark de Wever 365c06e709 Initialize all members.
Remove the leading whitespace.
2008-07-18 15:49:42 +00:00

72 lines
2.0 KiB
C++

/* $Id$ */
/*
Copyright (C) 2006 - 2008 by Joerg Hinrichs <joerg.hinrichs@alice-dsl.de>
Part of the Battle for Wesnoth Project http://www.wesnoth.org/
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License version 2
or at your option any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY.
See the COPYING file for more details.
*/
#ifndef GENERIC_EVENT_HPP_INCLUDED
#define GENERIC_EVENT_HPP_INCLUDED
#include "global.hpp"
#include <string>
#include <vector>
/*
This is the basic framework for generic events. In contrast to events.cpp
it does not concentrate on SDL events but events that wesnoth itself raises.
It is also different to game_events.cpp in that it does not work with
specific events but rather defines a generic framework.
*/
namespace events{
/*
This is the observer that gets notified, if a generic event takes place
Use this as base class for every class that is supposed to react on a
generic event.
*/
class observer{
public:
virtual void handle_generic_event(const std::string& event_name) = 0;
virtual ~observer() {}
};
/*
This is the class that notifies the observers and maintains a list of them.
*/
class generic_event{
public:
generic_event(std::string name);
virtual ~generic_event() {}
virtual bool attach_handler(observer* obs);
virtual bool detach_handler(observer* obs);
virtual void notify_observers();
private:
//Name of the event to help event handlers distinguish between several events
std::string name_;
//List of all subscribers waiting to react on this event
std::vector<observer*> observers_;
//This flag makes sure, that an event is not raised while the vector of
//observers is changed through attach_handler or detach_handler
bool change_handler_;
//This flag makes sure, that attaching/detaching event handlers does not
//take place during notify of observers to prevent iterator corruption.
bool notify_active_;
};
}
#endif