X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/bddd7a8d8953cf4c09e56c13e1bfcc594ba0267e..f77c0fe312a1dedde4a86c9b967d095802c10384:/include/wx/module.h?ds=inline diff --git a/include/wx/module.h b/include/wx/module.h index 181dff1e29..e255fe8bbd 100644 --- a/include/wx/module.h +++ b/include/wx/module.h @@ -1,5 +1,5 @@ ///////////////////////////////////////////////////////////////////////////// -// Name: module.h +// Name: wx/module.h // Purpose: Modules handling // Author: Wolfram Gloger/adapted by Guilhem Lavaux // Modified by: @@ -9,19 +9,21 @@ // Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// -#ifndef _WX_MODULEH__ -#define _WX_MODULEH__ - -#if defined(__GNUG__) && !defined(__APPLE__) - #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 @@ -32,36 +34,70 @@ 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 + // Override both of these + // called on program startup virtual bool OnInit() = 0; - // called just before program termination, but only if OnInit() + // 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 + // used by wxObjectLoader when unloading shared libs's - static void UnregisterModule(wxModule* module); + 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_