codeblocks-dev 10.05-2 / usr / include / codeblocks / menuitemsmanager.h

/*
 * This file is part of the Code::Blocks IDE and licensed under the GNU Lesser General Public License, version 3
 * http://www.gnu.org/licenses/lgpl-3.0.html
 */

#ifndef MENUITEMSMANAGER_H
#define MENUITEMSMANAGER_H

#include "settings.h"
#include <wx/menu.h>

WX_DEFINE_ARRAY(wxMenuItem*, MenuItemsList);

/**
  * @brief Manager for wxMenuItem pointers.
  *
  * This class manages an array of wxMenuItem pointers. Usually used by
  * classes that need to create menu items in the app and, at some point,
  * remove them *without* messing with other menu items, created by other
  * classes. Useful for plugins.\n
  * To use it, add a MenuItemsManager variable in your class and then
  * use MenuItemsManager::Add() to add menu items to a menu (instead of
  * wxMenu::Append). When you no longer want those menu items, call
  * MenuItemsManager::Clear(). That's it.
  *
  * @author Yiannis Mandravellos
  */
class DLLIMPORT MenuItemsManager
{
    public:
        MenuItemsManager(bool autoClearOnDestroy = true);
        virtual ~MenuItemsManager();

        virtual wxMenuItem* CreateFromString(const wxString& menuPath, int id);

        virtual wxMenuItem* Add(wxMenu* parent, int id, const wxString& caption, const wxString& helptext);
        virtual wxMenuItem* Insert(wxMenu* parent, int index, int id, const wxString& caption, const wxString& helptext);
        virtual void Clear();
    protected:
        MenuItemsList m_MenuItems; // The managed array of wxMenuItem pointers
        bool m_AutoClearOnDestroy; // if true, the menus are cleared in the destructor
    private:
};

#endif // MENUITEMSMANAGER_H