wxTopLevelWindows is now a wxWindowList, better compatibility with the old

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

/////////////////////////////////////////////////////////////////////////////
// Name:        module.h
// Purpose:     Modules handling
// Author:      Wolfram Gloger/adapted by Guilhem Lavaux
// Modified by:
// Created:     04/11/98
// RCS-ID:      $Id$
// Copyright:   (c) Wolfram Gloger and Guilhem Lavaux
// Licence:     wxWindows licence
/////////////////////////////////////////////////////////////////////////////

#ifndef _WX_MODULEH__
#define _WX_MODULEH__

#ifdef __GNUG__
    #pragma interface "module.h"
#endif

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

// declare a linked list of modules
class wxModule;
WX_DECLARE_LIST(wxModule, wxModuleList);

// 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
{
public:
    wxModule() {}
    virtual ~wxModule() {}

    // if module init routine returns FALSE 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 RegisterModules();
    static bool InitializeModules();
    static void CleanUpModules();

protected:
    static wxModuleList m_modules;

    DECLARE_CLASS(wxModule)
};

#endif // _WX_MODULEH__