Salome HOME
Updated copyright comment
[modules/gui.git] / src / CAM / CAM_Application.h
index 93f7c266b704cc484c4d3fd228900790fc03b17f..604b4c71b15b5f2519d9bac20f767eec4f7e8ac6 100644 (file)
@@ -1,4 +1,4 @@
-// Copyright (C) 2007-2020  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
@@ -35,7 +35,7 @@ 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
 
@@ -55,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* );
 
@@ -64,9 +65,12 @@ public:
 
   virtual bool        activateModule( const QString& );
 
-  bool                activateOperation( const QString& modName, int actionId );
-  bool                activateOperation( const QString& modName, const QString& actionId );
-  bool                activateOperation( const QString& modName, const QString& actionId,
+  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& );
@@ -75,19 +79,29 @@ public:
   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      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 );
@@ -96,21 +110,25 @@ protected:
 
   virtual bool        abortAllOperations();
 
-private:
-  void                readModuleList();
+protected:
+  bool                appendModuleInfo( const QString& );
+  void                removeModuleInfo( const QString& );
 
 private:
-  enum { stUnknown = 0, stNoGui, stInaccessible, stReady };
-  typedef struct { 
+  enum { stInvalid = -1, stUnknown = 0, stNoGui, stInaccessible, stReady };
+  struct ModuleInfo
+  {
     QString name, title, icon, library, version, description, displayer;
     int status;
-  } ModuleInfo;
-  typedef QList<ModuleInfo> ModuleInfoList;
+    ModuleInfo() : status( stInvalid ) {}
+  };
+  void                readModuleList();
 
 private:
+  typedef QList<ModuleInfo> ModuleInfoList;
+  static ModuleInfoList myInfoList;      //!< modules info list
   CAM_Module*           myModule;        //!< active module
   ModuleList            myModules;       //!< loaded modules list
-  static ModuleInfoList myInfoList;      //!< modules info list
   bool                  myAutoLoad;      //!< auto loading flag
   bool                  myBlocked;       //!< "blocked" flag, internal usage
 };