Salome HOME
Updated copyright comment
[modules/gui.git] / src / CAM / CAM_Application.h
old mode 100755 (executable)
new mode 100644 (file)
index 5ce5405..604b4c7
@@ -1,24 +1,25 @@
-//  Copyright (C) 2007-2008  CEA/DEN, EDF R&D, OPEN CASCADE
+// Copyright (C) 2007-2024  CEA, EDF, OPEN CASCADE
 //
-//  Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
-//  CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
+// Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
+// CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
 //
-//  This library is free software; you can redistribute it and/or
-//  modify it under the terms of the GNU Lesser General Public
-//  License as published by the Free Software Foundation; either
-//  version 2.1 of the License.
+// This library is free software; you can redistribute it and/or
+// modify it under the terms of the GNU Lesser General Public
+// License as published by the Free Software Foundation; either
+// version 2.1 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
-//  Lesser General Public License for more details.
+// 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
+// Lesser General Public License for more details.
 //
-//  You should have received a copy of the GNU Lesser General Public
-//  License along with this library; if not, write to the Free Software
-//  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
+// You should have received a copy of the GNU Lesser General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
 //
-//  See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
+// See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
 //
+
 #ifndef CAM_APPLICATION_H
 #define CAM_APPLICATION_H
 
@@ -34,12 +35,14 @@ class CAM_Module;
 #pragma warning( disable:4251 )
 #endif
 
-class CAM_EXPORT CAM_Application : public STD_Application  
+class CAM_EXPORT CAM_Application : public STD_Application
 {
   Q_OBJECT
 
 public:
   typedef QList<CAM_Module*> ModuleList;
+  typedef struct { QString name;  QString version; } ModuleShortInfo;
+  typedef QList<ModuleShortInfo> ModuleShortInfoList;
 
 public:
   CAM_Application( const bool = true );
@@ -52,7 +55,8 @@ public:
 
   ModuleList          modules() const;
   void                modules( ModuleList& ) const;
-  void                modules( QStringList&, const bool loaded = true ) const;
+  void                modules( QStringList&,
+                               const bool loaded = true ) const;
 
   virtual void        addModule( CAM_Module* );
 
@@ -61,38 +65,72 @@ public:
 
   virtual bool        activateModule( const QString& );
 
+  bool                activateOperation( const QString& modName,
+                                         const int actionId );
+  bool                activateOperation( const QString& modName,
+                                         const QString& actionId );
+  bool                activateOperation( const QString& modName,
+                                         const QString& actionId,
+                                         const QString& pluginName );
+
   virtual void        contextMenuPopup( const QString&, QMenu*, QString& );
 
-  QString             moduleName( const QString& ) const;
-  QString             moduleTitle( const QString& ) const;
-  QString             moduleIcon( const QString& ) const;
+  static QString      moduleName( const QString& );
+  static QString      moduleTitle( const QString& );
+  static QString      moduleIcon( const QString& );
+  static QString      moduleDescription( const QString& );
+  static QString      moduleLibrary( const QString&,
+                                     const bool = true );
+  static QString      moduleDisplayer( const QString& );
 
   virtual void        createEmptyStudy();
 
+  static ModuleShortInfoList getVersionInfo();
+
+  static void         logUserEvent( const QString& );
+  static void         logAction( QAction*, const QString& = QString() );
+  static void         logStructuredUserEvent( const QString& module,
+                                              const QString& section,
+                                              const QString& action,
+                                              const QString& event,
+                                              const QString& message = "" );
+
 protected:
   virtual SUIT_Study* createNewStudy();
   virtual void        updateCommandsStatus();
 
+  virtual bool        checkModule( const QString& );
   virtual void        moduleAdded( CAM_Module* );
+  virtual void        moduleDeactivated( CAM_Module* );
   virtual void        beforeCloseDoc( SUIT_Study* );
+  virtual void        afterCloseDoc();
   virtual bool        activateModule( CAM_Module* = 0 );
 
   virtual void        setActiveStudy( SUIT_Study* );
 
-  QString             moduleLibrary( const QString&, const bool = true ) const;
+  virtual bool        abortAllOperations();
+
+protected:
+  bool                appendModuleInfo( const QString& );
+  void                removeModuleInfo( const QString& );
 
 private:
+  enum { stInvalid = -1, stUnknown = 0, stNoGui, stInaccessible, stReady };
+  struct ModuleInfo
+  {
+    QString name, title, icon, library, version, description, displayer;
+    int status;
+    ModuleInfo() : status( stInvalid ) {}
+  };
   void                readModuleList();
 
 private:
-  typedef struct { QString name, title, internal, icon; } ModuleInfo;
   typedef QList<ModuleInfo> ModuleInfoList;
-
-private:
-  CAM_Module*         myModule;        //!< active module
-  ModuleList          myModules;       //!< loaded modules list
-  ModuleInfoList      myInfoList;      //!< modules info list
-  bool                myAutoLoad;      //!< auto loading flag
+  static ModuleInfoList myInfoList;      //!< modules info list
+  CAM_Module*           myModule;        //!< active module
+  ModuleList            myModules;       //!< loaded modules list
+  bool                  myAutoLoad;      //!< auto loading flag
+  bool                  myBlocked;       //!< "blocked" flag, internal usage
 };
 
 #ifdef WIN32