/usr/include/codeblocks/projectloader_hooks.h is in codeblocks-dev 13.12+dfsg-4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | /*
* This file is part of the Code::Blocks IDE and licensed under the GNU Lesser General Public License, version 3
* http://www.gnu.org/licenses/lgpl-3.0.html
*/
#ifndef PROJECTLOADER_HOOKS_H
#define PROJECTLOADER_HOOKS_H
#include "settings.h"
class TiXmlElement;
class cbProject;
/** Provides static functions to add hooks to the project loading/saving procedure. */
namespace ProjectLoaderHooks
{
/** Abstract base hook functor interface. */
class DLLIMPORT HookFunctorBase
{
public:
virtual ~HookFunctorBase(){}
virtual void Call(cbProject*, TiXmlElement*, bool) const = 0;
};
/** Functor class for use as a project loading/saving hook.
* Passed as the first parameter in RegisterHook() and
* UnregisterHook().
*
* example:
* ProjectLoaderHooks::HookFunctorBase* myhook = new ProjectLoaderHooks::HookFunctor<MyClass>(this, &MyClass::OnHookCalled);
* int id = ProjectLoaderHooks::RegisterHook(myhook);
* ...
* (and before your class' destruction - or earlier):
* ProjectLoaderHooks::UnregisterHook(id, true);
*
* Member functions used as hook callbacks must have the following signature:
* void YourFunctionName(cbProject*, TiXmlElement*, bool)
*
* Use normal TinyXML procedures to work with the TiXmlElement* argument.
* The isLoading argument is true if your hook is called when the project is being loaded,
* and false when the project is saved.
*/
template<class T> class HookFunctor : public HookFunctorBase
{
public:
typedef void (T::*Func)(cbProject*, TiXmlElement*, bool);
HookFunctor(T* obj, Func func) : m_pObj(obj), m_pFunc(func)
{ ; }
virtual void Call(cbProject* project, TiXmlElement* elem, bool isLoading) const
{
if (m_pObj && m_pFunc)
(m_pObj->*m_pFunc)(project, elem, isLoading);
}
protected:
T* m_pObj;
Func m_pFunc;
};
/** Register a project loading/saving hook.
* @param functor The functor to use as a callback.
* @return An ID. Use this to unregister your hook later.
*/
extern DLLIMPORT int RegisterHook(HookFunctorBase* functor);
/** Unregister a previously registered project loading/saving hook.
* @param id The hook's ID. You should have the ID from when RegisterHook() was called.
* @param deleteHook If true, the hook will be deleted (default). If not, it's
* up to you to delete it.
* @return The functor. If @c deleteHook was true, it always returns NULL.
*/
extern DLLIMPORT HookFunctorBase* UnregisterHook(int id, bool deleteHook = true);
/** Are there any hooks registered?
* @return True if any hooks are registered, false if none.
*/
extern DLLIMPORT bool HasRegisteredHooks();
/** Call all registered hooks using the supplied parameters.
* This is called by ProjectLoader.
* @param project The project in question.
* @param elem The XML element under which the called hook can read/write.
* @param isLoading True if the project is being loaded, false if being saved.
*/
extern DLLIMPORT void CallHooks(cbProject* project, TiXmlElement* elem, bool isLoading);
}
#endif // PROJECTLOADER_HOOKS_H
|