Some documentation enhancements for wxRichTextCtrl

[wxWidgets.git] / docs / latex / wx / module.tex

diff --git a/docs/latex/wx/module.tex b/docs/latex/wx/module.tex
index 85825cadc463fa852f03bd32020ac90bbe7035b5..754a5e039e09fe0c78976580d6f8223d2f392c4b 100644 (file)
--- a/docs/latex/wx/module.tex
+++ b/docs/latex/wx/module.tex
@@ -1,14 +1,16 @@
 \section{\class{wxModule}}\label{wxmodule}
 
 \section{\class{wxModule}}\label{wxmodule}
 

-The module system is a very simple mechanism to allow applications (and parts of wxWidgets itself) to
-define initialization and cleanup functions that are automatically called on wxWidgets
-startup and exit.
-
-To define a new kind of module, derive a class from wxModule, override the OnInit and OnExit functions,
-and add the DECLARE\_DYNAMIC\_CLASS and IMPLEMENT\_DYNAMIC\_CLASS to header and implementation files
-(which can be the same file). On initialization, wxWidgets will find all classes derived from wxModule,
-create an instance of each, and call each OnInit function. On exit, wxWidgets will call the OnExit
-function for each module instance.
+The module system is a very simple mechanism to allow applications (and parts
+of wxWidgets itself) to define initialization and cleanup functions that are
+automatically called on wxWidgets startup and exit.
+
+To define a new kind of module, derive a class from wxModule, override the
+\helpref{OnInit}{wxmoduleoninit} and \helpref{OnExit}{wxmoduleonexit} 
+functions, and add the DECLARE\_DYNAMIC\_CLASS and IMPLEMENT\_DYNAMIC\_CLASS to
+header and implementation files (which can be the same file). On
+initialization, wxWidgets will find all classes derived from wxModule, create
+an instance of each, and call each OnInit function. On exit, wxWidgets will
+call the OnExit function for each module instance.

 
 Note that your module class does not have to be in a header file.
 
 
 Note that your module class does not have to be in a header file.
 


@@ -18,17 +20,31 @@ For example:
   // A module to allow DDE initialization/cleanup
   // without calling these functions from app.cpp or from
   // the user's application.
   // A module to allow DDE initialization/cleanup
   // without calling these functions from app.cpp or from
   // the user's application.

-

   class wxDDEModule: public wxModule
   {
   class wxDDEModule: public wxModule
   {

-  DECLARE_DYNAMIC_CLASS(wxDDEModule)

   public:
   public:

-      wxDDEModule() {}
-      bool OnInit() { wxDDEInitialize(); return true; };
-      void OnExit() { wxDDECleanUp(); };
+      wxDDEModule() { }
+      virtual bool OnInit() { wxDDEInitialize(); return true; };
+      virtual void OnExit() { wxDDECleanUp(); };
+
+  private:
+      DECLARE_DYNAMIC_CLASS(wxDDEModule)

   };
 
   IMPLEMENT_DYNAMIC_CLASS(wxDDEModule, wxModule)
   };
 
   IMPLEMENT_DYNAMIC_CLASS(wxDDEModule, wxModule)

+
+
+  // Another module which uses DDE in its OnInit()
+  class MyModule: public wxModule
+  {
+  public:
+      wxDDEModule() { AddDependency(CLASSINFO(wxDDEModule)); }
+      virtual bool OnInit() { ... code using DDE ... }
+      virtual void OnExit() { ... }
+
+  private:
+      DECLARE_DYNAMIC_CLASS(wxDDEModule)
+  };

 \end{verbatim}
 
 \wxheading{Derived from}
 \end{verbatim}
 
 \wxheading{Derived from}


@@ -41,45 +57,36 @@ For example:
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 

+

 \membersection{wxModule::wxModule}\label{wxmodulector}
 
 \func{}{wxModule}{\void}
 
 Constructs a wxModule object.
 
 \membersection{wxModule::wxModule}\label{wxmodulector}
 
 \func{}{wxModule}{\void}
 
 Constructs a wxModule object.
 

+

 \membersection{wxModule::\destruct{wxModule}}\label{wxmoduledtor}
 
 \func{}{\destruct{wxModule}}{\void}
 
 Destructor.
 
 \membersection{wxModule::\destruct{wxModule}}\label{wxmoduledtor}
 
 \func{}{\destruct{wxModule}}{\void}
 
 Destructor.
 

-\membersection{wxModule::CleanupModules}\label{wxmodulecleanupmodules}

 
 

-\func{static void}{CleanupModules}{\void}
+\membersection{wxModule::AddDependency}\label{wxmoduleoninit}

 
 

-Calls Exit for each module instance. Called by wxWidgets on exit, so there is no
-need for an application to call it.
+\func{void}{AddDependency}{\param{wxClassInfo * }{dep}}

 
 

-\membersection{wxModule::Exit}\label{wxmoduleexit}
+Call this function from the constructor of the derived class. \arg{dep} must be
+the \helpref{CLASSINFO}{classinfo} of a wxModule-derived class and the
+corresponding module will be loaded \emph{before} and unloaded \emph{after}
+this module.

 
 

-\func{void}{Exit}{\void}
+Note that circular dependencies are detected and result in a fatal error.

 
 

-Calls OnExit. This function is called by wxWidgets and should not need to be called
-by an application.
+\wxheading{Parameters}

 
 

-\membersection{wxModule::Init}\label{wxmoduleinit}
+\docparam{dep}{The class information object for the dependent module.}

 
 

-\func{bool}{Init}{\void}
-
-Calls OnInit. This function is called by wxWidgets and should not need to be called
-by an application.
-
-\membersection{wxModule::InitializeModules}\label{wxmoduleinitializemodules}
-
-\func{static bool}{InitializeModules}{\void}
-
-Calls Init for each module instance. Called by wxWidgets on startup, so there is no
-need for an application to call it.

 
 \membersection{wxModule::OnExit}\label{wxmoduleonexit}
 
 
 \membersection{wxModule::OnExit}\label{wxmoduleonexit}
 


@@ -87,6 +94,7 @@ need for an application to call it.
 
 Provide this function with appropriate cleanup for your module.
 
 
 Provide this function with appropriate cleanup for your module.
 

+

 \membersection{wxModule::OnInit}\label{wxmoduleoninit}
 
 \func{virtual bool}{OnInit}{\void}
 \membersection{wxModule::OnInit}\label{wxmoduleoninit}
 
 \func{virtual bool}{OnInit}{\void}


@@ -94,17 +102,3 @@ Provide this function with appropriate cleanup for your module.
 Provide this function with appropriate initialization for your module. If the function
 returns false, wxWidgets will exit immediately.
 
 Provide this function with appropriate initialization for your module. If the function
 returns false, wxWidgets will exit immediately.
 

-\membersection{wxModule::RegisterModule}\label{wxmoduleregistermodule}
-
-\func{static void}{RegisterModule}{\param{wxModule*}{ module}}
-
-Registers this module with wxWidgets. Called by wxWidgets on startup, so there is no
-need for an application to call it.
-
-\membersection{wxModule::RegisterModules}\label{wxmoduleregistermodules}
-
-\func{static bool}{RegisterModules}{\void}
-
-Creates instances of and registers all modules. Called by wxWidgets on startup, so there is no
-need for an application to call it.
-