108 lines
3.5 KiB
C++
108 lines
3.5 KiB
C++
/*
|
|
PIP - Platform Independent Primitives
|
|
Object, base class of some PIP classes, provide EVENT -> EVENT_HANDLER mechanism
|
|
Copyright (C) 2013 Ivan Pelipenko peri4ko@gmail.com
|
|
|
|
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 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program 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 General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#include "piobject.h"
|
|
|
|
PIVector<PIObject * > PIObject::objects;
|
|
|
|
|
|
/** \class PIObject
|
|
* \brief This is base class for any classes which use events -> handlers mechanism.
|
|
* \details
|
|
* \section PIObject_sec0 Events and Event handlers
|
|
* %PIObject provide notification mechanism similar Qt but implemented
|
|
* on language capabilities without any special preprocessors or compilers.
|
|
* Any class inherits PIObject should use macro \a PIOBJECT() immediate
|
|
* after declaration to proper compile.
|
|
*
|
|
* Event is a some abstract event that can be raised at any time.
|
|
* Event is a function but declared with special macro \a EVENT().
|
|
* To raise event simply execute event function.
|
|
*
|
|
* Event handler is a function but declared with special macro
|
|
* \a EVENT_HANDLER(). You can use event handlers as ordinary functions.
|
|
*
|
|
* Main goal of this mechanism is perform abstract connections between
|
|
* various objects. This functionality provide macro \a CONNECT() which
|
|
* connect some event of first object to some event handler or event of
|
|
* second object. Each event can be connected any times to any event handlers.
|
|
*
|
|
* \image html events_handlers.png
|
|
*
|
|
* Example: \snippet piobject.cpp main
|
|
* Result:
|
|
\code{.cpp}
|
|
handler B: 2 , 0.5
|
|
handler A: event to handler
|
|
handler A: event to event
|
|
\endcode
|
|
*/
|
|
|
|
|
|
void PIObject::piConnect(const PIString & src, const PIString & sig, void * dest, void * ev_h) {
|
|
PIObject * o = findByName(src);
|
|
if (o == 0) {
|
|
piCout << "[PIObject] Can`t find object with name \"" << src << "\"!";
|
|
return;
|
|
}
|
|
o->connections << Connection(ev_h, 0, sig, dest);
|
|
}
|
|
|
|
|
|
void PIObject::piConnect(PIObject * src, const PIString & sig, const PIString & dest, void * ev_h) {
|
|
PIObject * o = findByName(dest);
|
|
if (o == 0) {
|
|
piCout << "[PIObject] Can`t find object with name \"" << dest << "\"!";
|
|
return;
|
|
}
|
|
src->connections << Connection(ev_h, 0, sig, o);
|
|
}
|
|
|
|
|
|
void PIObject::piConnect(const PIString & src, const PIString & sig, const PIString & dest, void * ev_h) {
|
|
PIObject * s = findByName(src);
|
|
if (s == 0) {
|
|
piCout << "[PIObject] Can`t find object with name \"" << src << "\"!";
|
|
return;
|
|
}
|
|
PIObject * d = findByName(dest);
|
|
if (d == 0) {
|
|
piCout << "[PIObject] Can`t find object with name \"" << dest << "\"!";
|
|
return;
|
|
}
|
|
s->connections << Connection(ev_h, 0, sig, d);
|
|
}
|
|
|
|
/*
|
|
PIStringList PIObject::events() {
|
|
PIStringList l;
|
|
for (PIMap<NamedFunction, PIString>::const_iterator i = signals_.begin(); i != signals_.end(); i++)
|
|
l << (*i).first;
|
|
return l;
|
|
}
|
|
|
|
|
|
PIStringList PIObject::eventHandlers() {
|
|
PIStringList l;
|
|
for (PIMap<NamedFunction, PIString>::const_iterator i = slots_.begin(); i != slots_.end(); i++)
|
|
l << (*i).first;
|
|
return l;
|
|
}
|
|
*/
|