added wxDataViewIndexListModel and sample

[wxWidgets.git] / include / wx / module.h

diff --git a/include/wx/module.h b/include/wx/module.h
index 852b341db40c7d7bcbfdea90c250c9921ed093e9..e255fe8bbd4bbc151bc708fef4c3945506db160f 100644 (file)
--- 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:
 // Purpose:     Modules handling
 // Author:      Wolfram Gloger/adapted by Guilhem Lavaux
 // Modified by:


@@ -9,20 +9,22 @@
 // Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 
 // Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 

-#ifndef _WX_MODULEH__
-#define _WX_MODULEH__
-
-#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
-    #pragma interface "module.h"
-#endif
+#ifndef _WX_MODULE_H_
+#define _WX_MODULE_H_

 
 #include "wx/object.h"
 #include "wx/list.h"
 
 #include "wx/object.h"
 #include "wx/list.h"

+#include "wx/dynarray.h"

 
 // declare a linked list of modules
 
 // declare a linked list of modules

-class wxModule;
+class WXDLLIMPEXP_FWD_BASE wxModule;

 WX_DECLARE_USER_EXPORTED_LIST(wxModule, wxModuleList, WXDLLIMPEXP_BASE);
 
 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)
 // 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)


@@ -32,36 +34,70 @@ public:
     wxModule() {}
     virtual ~wxModule() {}
 
     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(); }
 
 
     bool Init() { return OnInit(); }
     void Exit() { OnExit(); }
 

-       // Override both of these
+    // Override both of these
+

         // called on program startup
 
     virtual bool OnInit() = 0;
 
         // 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
         // succeeded

-    
+

     virtual void OnExit() = 0;
 
     virtual void OnExit() = 0;
 

-    static void RegisterModule(wxModule* module);
+    static void RegisterModule(wxModule *module);

     static void RegisterModules();
     static bool InitializeModules();
     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;
 
 
 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)
 };
 
     DECLARE_CLASS(wxModule)
 };
 

-#endif // _WX_MODULEH__
-
+#endif // _WX_MODULE_H_