Gui/Application.h

Go to the documentation of this file.

/***************************************************************************
 *   Copyright (c) 2004 Jürgen Riegel <juergen.riegel@web.de>              *
 *                                                                         *
 *   This file is part of the FreeCAD CAx development system.              *
 *                                                                         *
 *   This library is free software; you can redistribute it and/or         *
 *   modify it under the terms of the GNU Library General Public           *
 *   License as published by the Free Software Foundation; either          *
 *   version 2 of the License, or (at your option) any later version.      *
 *                                                                         *
 *   This library  is distributed in the hope that it will be useful,      *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU Library General Public License for more details.                  *
 *                                                                         *
 *   You should have received a copy of the GNU Library General Public     *
 *   License along with this library; see the file COPYING.LIB. If not,    *
 *   write to the Free Software Foundation, Inc., 59 Temple Place,         *
 *   Suite 330, Boston, MA  02111-1307, USA                                *
 *                                                                         *
 ***************************************************************************/


#ifndef APPLICATION_H
#define APPLICATION_H

#include <QPixmap>
#include <string>
#include <vector>

#define  putpix()

#include <App/Application.h>

class QCloseEvent;

namespace Gui{
class BaseView;
class CommandManager;
class Document;
class MacroManager;
class MDIView;
class MainWindow;
class MenuItem;
class ViewProvider;

class GuiExport Application 
{
public:
    Application(bool GUIenabled);
    ~Application();


    void open(const char* FileName, const char* Module);
    void importFrom(const char* FileName, const char* DocName, const char* Module);
    void exportTo(const char* FileName, const char* DocName, const char* Module);



    bool sendMsgToActiveView(const char* pMsg, const char** ppReturn=0);
    bool sendHasMsgToActiveView(const char* pMsg);
    void attachView(Gui::BaseView* pcView);
    void detachView(Gui::BaseView* pcView);
    void viewActivated(Gui::MDIView* pcView);
    void onUpdate(void);
    void updateActive(void);


    boost::signal<void (const Gui::Document&)> signalNewDocument;
    boost::signal<void (const Gui::Document&)> signalDeleteDocument;
    boost::signal<void (const Gui::Document&)> signalRelabelDocument;
    boost::signal<void (const Gui::Document&)> signalRenameDocument;
    boost::signal<void (const Gui::Document&)> signalActiveDocument;
    boost::signal<void (const Gui::ViewProvider&)> signalNewObject;
    boost::signal<void (const Gui::ViewProvider&)> signalDeletedObject;
    boost::signal<void (const Gui::ViewProvider&, const App::Property&)> signalChangedObject;
    boost::signal<void (const Gui::ViewProvider&)> signalRenamedObject;
    boost::signal<void (const Gui::ViewProvider&)> signalActivatedObject;
    boost::signal<void (const char*)> signalActivateWorkbench;
    boost::signal<void (const char*)> signalAddWorkbench;
    boost::signal<void (const char*)> signalRemoveWorkbench;
    boost::signal<void (const Gui::MDIView*)> signalActivateView;

protected:
    void slotNewDocument(const App::Document&);
    void slotDeleteDocument(const App::Document&);
    void slotRelabelDocument(const App::Document&);
    void slotRenameDocument(const App::Document&);
    void slotActiveDocument(const App::Document&);
    void slotNewObject(const ViewProvider&);
    void slotDeletedObject(const ViewProvider&);
    void slotChangedObject(const ViewProvider&, const App::Property& Prop);
    void slotRenamedObject(const ViewProvider&);
    void slotActivatedObject(const ViewProvider&);

public:
    void onLastWindowClosed(Gui::Document* pcDoc);
    Gui::Document* activeDocument(void) const;
    void setActiveDocument(Gui::Document* pcDocument);
    Gui::Document* getDocument(const char* name) const;
    Gui::Document* getDocument(const App::Document* pDoc) const;
    void showViewProvider(App::DocumentObject*);
    void hideViewProvider(App::DocumentObject*);
    Gui::ViewProvider* getViewProvider(App::DocumentObject*) const;

    bool isClosing(void);


    bool activateWorkbench(const char* name);
    QPixmap workbenchIcon(const QString&) const;
    QString workbenchToolTip(const QString&) const;
    QString workbenchMenuText(const QString&) const;
    QStringList workbenches(void) const;
    void setupContextMenu(const char* recipient, MenuItem*) const;


    Gui::MacroManager *macroManager(void);
    Gui::CommandManager &commandManager(void);
    void runCommand(bool bForce, const char* sCmd,...);
    bool runPythonCode(const char* cmd, bool gui=false, bool pyexc=true);
    void createStandardOperations();


    static Application* Instance;
    static void initApplication(void);
    static void initTypes(void);
    static void runApplication(void);
    void tryClose( QCloseEvent * e );

public:
    //---------------------------------------------------------------------
    // python exports goes here +++++++++++++++++++++++++++++++++++++++++++     
    //---------------------------------------------------------------------
    // static python wrapper of the exported functions
    PYFUNCDEF_S(sActivateWorkbenchHandler); // activates a workbench object
    PYFUNCDEF_S(sAddWorkbenchHandler);      // adds a new workbench handler to a list
    PYFUNCDEF_S(sRemoveWorkbenchHandler);   // removes a workbench handler from the list
    PYFUNCDEF_S(sGetWorkbenchHandler);      // retrieves the workbench handler
    PYFUNCDEF_S(sListWorkbenchHandlers);    // retrieves a list of all workbench handlers
    PYFUNCDEF_S(sActiveWorkbenchHandler);   // retrieves the active workbench object
    PYFUNCDEF_S(sAddResPath);               // adds a path where to find resources
    PYFUNCDEF_S(sAddLangPath);              // adds a path to a qm file
    PYFUNCDEF_S(sAddIconPath);              // adds a path to an icon file
    PYFUNCDEF_S(sAddIcon);                  // adds an icon to the cache

    PYFUNCDEF_S(sSendActiveView);

    PYFUNCDEF_S(sUpdateGui);
    PYFUNCDEF_S(sUpdateLocale);
    PYFUNCDEF_S(sGetLocale);
    PYFUNCDEF_S(sCreateDialog);
    PYFUNCDEF_S(sAddPreferencePage);

    PYFUNCDEF_S(sRunCommand);
    PYFUNCDEF_S(sAddCommand);

    PYFUNCDEF_S(sHide);                     // deprecated
    PYFUNCDEF_S(sShow);                     // deprecated
    PYFUNCDEF_S(sHideObject);               // hide view provider object
    PYFUNCDEF_S(sShowObject);               // show view provider object

    PYFUNCDEF_S(sOpen);                     // open Python scripts
    PYFUNCDEF_S(sInsert);                   // open Python scripts
    PYFUNCDEF_S(sExport);

    PYFUNCDEF_S(sActiveDocument);
    PYFUNCDEF_S(sGetDocument);

    static PyMethodDef    Methods[]; 

private:
    struct ApplicationP* d;
    PyObject*             _pcWorkbenchDictionary;
};

} //namespace Gui

#endif