Salome HOME
#2309 Possibility to hide faces
[modules/shaper.git] / src / ModuleBase / ModuleBase_IModule.h
index b74ea6c074942d7998c0f57d6b212942f6783540..4290fc3cdee0c93303e9aa60341f4faf16d48bf0 100755 (executable)
@@ -1,3 +1,23 @@
+// Copyright (C) 2014-2017  CEA/DEN, EDF R&D
+//
+// 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.
+//
+// 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<mailto:webmaster.salome@opencascade.com>
+//
+
  // Copyright (C) 2014-20xx CEA/DEN, EDF R&D
 
 #ifndef ModuleBase_IModule_H
@@ -28,10 +48,13 @@ class QMenu;
 class Config_WidgetAPI;
 class ModuleBase_ModelWidget;
 class ModuleBase_Operation;
+class ModuleBase_ViewerPrs;
+
 class ModuleBase_IWorkshop;
 class ModelAPI_Result;
+class Events_Message;
 
-class Handle_AIS_InteractiveObject;
+class AIS_InteractiveObject;
 
 /**
  * \ingroup GUI
@@ -55,16 +78,19 @@ class MODULEBASE_EXPORT ModuleBase_IModule : public QObject
   virtual ~ModuleBase_IModule() {}
 
   /// Add default selection filters of the module to the current viewer
-  virtual void activateSelectionFilters() {};
+  virtual void activateSelectionFilters() {}
 
   /// Remove default selection filters of the module from the current viewer
-  virtual void deactivateSelectionFilters() {};
+  virtual void deactivateSelectionFilters() {}
+
+  /// Update selection filters depending on the module active controls
+  virtual void updateActiveSelectionFilters() {}
 
   /// Stores the current selection
-  virtual void storeSelection() {};
+  virtual void storeSelection() {}
 
   /// Restores the current selection
-  virtual void restoreSelection() {};
+  virtual void restoreSelection() {}
 
   /// Reads description of features from XML file
   virtual void createFeatures();
@@ -82,7 +108,10 @@ class MODULEBASE_EXPORT ModuleBase_IModule : public QObject
 
   /// Creates an operation and send it to loop
   /// \param theCmdId the operation name
-  virtual void launchOperation(const QString& theCmdId);
+  /// \param isStartAfterCommitOnly operation is launched if there is no active operation or
+  ///        it is committed
+  virtual void launchOperation(const QString& theCmdId,
+                               const bool& isStartAfterCommitOnly);
 
   /// Executes feature as a modal dialog box
   /// \param theCmdId the operation name
@@ -177,6 +206,14 @@ class MODULEBASE_EXPORT ModuleBase_IModule : public QObject
   /// \param theObject a model object
   virtual bool canDisplayObject(const ObjectPtr& theObject) const;
 
+  /// Returns whether the started operation may use preselection of the previous one
+  /// Cases are: previous operation is null, edit operation, previuos and started operations
+  /// kinds are the same
+  /// \param thePreviousOperationKind a kind of previous operation
+  /// \param theStartedOperationKind a kind of a started operation
+  virtual bool canUsePreselection(const QString& thePreviousOperationKind,
+                                  const QString& theStartedOperationKind);
+
   /// Make some functionality after the objects are hidden in viewer
   /// \param theObjects a list of hidden objects
   //virtual void processHiddenObject(const std::list<ObjectPtr>& theObjects) {};
@@ -229,6 +266,11 @@ class MODULEBASE_EXPORT ModuleBase_IModule : public QObject
                                      AISObjectPtr thePrs,
                                      GeomCustomPrsPtr theCustomPrs) { return false; };
 
+  /// Modifies the given presentation in the custom way after usual customize is performed.
+  virtual bool afterCustomisePresentation(std::shared_ptr<ModelAPI_Result> theResult,
+                                     AISObjectPtr thePrs,
+                                     GeomCustomPrsPtr theCustomPrs) { return false; };
+
   /// Update the object presentable properties such as color, lines width and other
   /// If the object is result with the color attribute value set, it is used,
   /// otherwise the customize is applyed to the object's feature if it is a custom prs
@@ -251,7 +293,7 @@ class MODULEBASE_EXPORT ModuleBase_IModule : public QObject
   /// Create specific for the module presentation
   /// \param theResult an object for presentation
   /// \return created presentation or NULL(default value)
-  virtual Handle_AIS_InteractiveObject createPresentation(
+  virtual Handle(AIS_InteractiveObject) createPresentation(
                            const std::shared_ptr<ModelAPI_Result>& theResult);
 
   //! Returns data object by AIS
@@ -312,6 +354,13 @@ class MODULEBASE_EXPORT ModuleBase_IModule : public QObject
   virtual AttributePtr findAttribute(const ObjectPtr& theObject,
                                      const GeomShapePtr& theGeomShape) = 0;
 
+  /// Returns reentrant message if it was accepted
+  virtual std::shared_ptr<Events_Message> reentrantMessage() = 0;
+
+  /// Put current selection into reentrant message
+  /// \param theMessage a message of reentrant operation
+  virtual void setReentrantPreSelection(const std::shared_ptr<Events_Message>& theMessage) = 0;
+
   /// Returns XML information by the feature index
   /// \param theFeatureId a feature id
   /// \param theXmlCfg XML configuration
@@ -320,9 +369,6 @@ class MODULEBASE_EXPORT ModuleBase_IModule : public QObject
                             std::string& theDescription);
 
 signals:
-  /// Signal which is emitted when operation is launched
-  void operationLaunched();
-
   /// Segnal emitted when an operation is resumed
   /// \param theOp a resumed operation
   void resumed(ModuleBase_Operation* theOp);
@@ -349,9 +395,6 @@ protected:
  /// Register validators for this module
   virtual void registerValidators() {}
 
-  /// Register selection filters for this module
-  virtual void registerFilters() {}
-
   /// Register properties of this module
   virtual void registerProperties() {}