/////////////////////////////////////////////////////////////////////////////
-// Name: module.h
+// Name: wx/module.h
// Purpose: Modules handling
// Author: Wolfram Gloger/adapted by Guilhem Lavaux
// Modified by:
// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
-#ifndef _WX_MODULEH__
-#define _WX_MODULEH__
-
-#ifdef __GNUG__
- #pragma interface "module.h"
-#endif
+#ifndef _WX_MODULE_H_
+#define _WX_MODULE_H_
#include "wx/object.h"
#include "wx/list.h"
+#include "wx/dynarray.h"
// declare a linked list of modules
-class wxModule;
-WX_DECLARE_EXPORTED_LIST(wxModule, wxModuleList);
+class WXDLLIMPEXP_FWD_BASE wxModule;
+WX_DECLARE_USER_EXPORTED_LIST(wxModule, wxModuleList, WXDLLIMPEXP_BASE);
+
+// and an array of class info objects
+WX_DEFINE_USER_EXPORTED_ARRAY_PTR(wxClassInfo *, wxArrayClassInfo,
+ class WXDLLIMPEXP_BASE);
+
// declaring a class derived from wxModule will automatically create an
// instance of this class on program startup, call its OnInit() method and call
// OnExit() on program termination (but only if OnInit() succeeded)
-class WXDLLEXPORT wxModule : public wxObject
+class WXDLLIMPEXP_BASE wxModule : public wxObject
{
public:
wxModule() {}
virtual ~wxModule() {}
- // if module init routine returns FALSE application will fail to startup
+ // if module init routine returns false the application
+ // will fail to startup
+
bool Init() { return OnInit(); }
void Exit() { OnExit(); }
// Override both of these
+
// called on program startup
+
virtual bool OnInit() = 0;
+
// called just before program termination, but only if OnInit()
// succeeded
+
virtual void OnExit() = 0;
- static void RegisterModule(wxModule* module);
+ static void RegisterModule(wxModule *module);
static void RegisterModules();
static bool InitializeModules();
- static void CleanUpModules();
+ static void CleanUpModules() { DoCleanUpModules(m_modules); }
+
+ // used by wxObjectLoader when unloading shared libs's
+
+ static void UnregisterModule(wxModule *module);
protected:
static wxModuleList m_modules;
+ // the function to call from constructor of a deriving class add module
+ // dependency which will be initialized before the module and unloaded
+ // after that
+ void AddDependency(wxClassInfo *dep)
+ {
+ wxCHECK_RET( dep, _T("NULL module dependency") );
+
+ m_dependencies.Add(dep);
+ }
+
+private:
+ // initialize module and Append it to initializedModules list recursively
+ // calling itself to satisfy module dependencies if needed
+ static bool
+ DoInitializeModule(wxModule *module, wxModuleList &initializedModules);
+
+ // cleanup the modules in the specified list (which may not contain all
+ // modules if we're called during initialization because not all modules
+ // could be initialized) and also empty m_modules itself
+ static void DoCleanUpModules(const wxModuleList& modules);
+
+
+ // module dependencies: contains
+ wxArrayClassInfo m_dependencies;
+
+ // used internally while initiliazing/cleaning up modules
+ enum
+ {
+ State_Registered, // module registered but not initialized yet
+ State_Initializing, // we're initializing this module but not done yet
+ State_Initialized // module initialized successfully
+ } m_state;
+
+
DECLARE_CLASS(wxModule)
};
-#endif // _WX_MODULEH__
-
+#endif // _WX_MODULE_H_