1 // Copyright (C) 2014-2017 CEA/DEN, EDF R&D
3 // This library is free software; you can redistribute it and/or
4 // modify it under the terms of the GNU Lesser General Public
5 // License as published by the Free Software Foundation; either
6 // version 2.1 of the License, or (at your option) any later version.
8 // This library is distributed in the hope that it will be useful,
9 // but WITHOUT ANY WARRANTY; without even the implied warranty of
10 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 // Lesser General Public License for more details.
13 // You should have received a copy of the GNU Lesser General Public
14 // License along with this library; if not, write to the Free Software
15 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17 // See http://www.salome-platform.org/ or
18 // email : webmaster.salome@opencascade.com<mailto:webmaster.salome@opencascade.com>
24 #include "SHAPER_SHAPERGUI.h"
25 #include "SHAPERGUI_SalomeViewer.h"
27 #include <LightApp_Module.h>
28 #include <XGUI_SalomeConnector.h>
30 #include <ModuleBase_ActionInfo.h>
32 #include <QStringList>
36 class SHAPERGUI_OCCSelector;
37 class OCCViewer_Viewer;
42 * An implementation of SALOME connector class for implementation of
43 * XGUI functionality as a module of SALOME
45 class SHAPERGUI_EXPORT SHAPERGUI : public LightApp_Module, public XGUI_SalomeConnector
52 //----- LightAPP_Module interface ---------------
54 /// \brief Initializing of the module
55 /// \param theApp application instance
56 virtual void initialize(CAM_Application* theApp);
58 /// \brief Definition of module standard windows
59 virtual void windows(QMap<int, int>& theWndMap) const;
61 /// \brief Definition of module viewer
62 virtual void viewManagers(QStringList& theList) const;
64 /// \brief The method is called on selection changed event
65 virtual void selectionChanged();
67 //--- XGUI connector interface -----
69 virtual QAction* addFeature(const QString& theWBName, const QString& theTBName,
70 const QString& theId, const QString& theTitle,
71 const QString& theTip, const QIcon& theIcon,
72 const QKeySequence& theKeys/* = QKeySequence()*/,
73 bool isCheckable /*= false*/, const bool isAddSeparator/* = false*/,
74 const QString& theStatusTip);
76 //! Add feature (QAction) in the \a theWBName toolbar with given \a theInfo about action
77 virtual QAction* addFeature(const QString& theWBName,
78 const ActionInfo& theInfo, const bool isAddSeparator);
80 /// Add a nested feature
81 /// \param theWBName a workbench name
82 /// \param theInfo the action parameters
83 /// \param theNestedActions a list of nested actions
84 virtual QAction* addFeatureOfNested(const QString& theWBName,
85 const ActionInfo& theInfo,
86 const QList<QAction*>& theNestedActions);
88 //! Returns true if the feature action is a nested action, in other words,
89 //! it is created by addNestedFeature().
90 //! \param theAction - an action of a feature
91 //! returns boolean result
92 virtual bool isFeatureOfNested(const QAction* theAction);
94 virtual QAction* addDesktopCommand(const QString& theId, const QString& theTitle,
95 const QString& theTip, const QIcon& theIcon,
96 const QKeySequence& theKeys, bool isCheckable,
97 const char* theMenuSourceText,
98 const int theMenuPosition = 10);
100 virtual void addDesktopMenuSeparator(const char* theMenuSourceText,
101 const int theMenuPosition = 10);
103 /// Add an action to a tool bar
104 /// \param theAction an ation to add
105 /// \param theToolBarTitle a name of tool bar
106 virtual bool addActionInToolbar( QAction* theAction, const QString& theToolBarTitle );
108 /// Creates menu/tool bar actions for loaded features stored in the menu manager
109 virtual void createFeatureActions();
111 virtual QMainWindow* desktop() const;
113 //! Stores XML information for the feature kind
114 //! \param theFeatureId a feature kind
115 //! \param theMessage a container of the feature XML properties
116 virtual void setFeatureInfo(const QString& theFeatureId,
117 const std::shared_ptr<Config_FeatureMessage>& theMessage);
119 //! Returns XML information for the feature kind
120 //! \param theFeatureId a feature kind
121 //! \return theMessage a container of the feature XML properties
122 virtual std::shared_ptr<Config_FeatureMessage> featureInfo(const QString& theFeatureId);
124 //! Returns interface to Salome viewer
125 virtual ModuleBase_IViewer* viewer() const
127 return myProxyViewer;
130 //! Returns list of defined actions (just by SHAPER module)
131 virtual QList<QAction*> commandList() const;
133 /// Redefinition of virtual function.
134 /// \param theClient name of pop-up client
135 /// \param theMenu popup menu instance
136 /// \param theTitle menu title.
137 virtual void contextMenuPopup(const QString& theClient, QMenu* theMenu, QString& theTitle);
139 /// Redefinition of virtual function for preferences creation.
140 virtual void createPreferences();
142 /// Redefinition of virtual function for preferences changed event.
143 virtual void preferencesChanged(const QString& theSection, const QString& theParam);
145 //! Shows the given text in status bar as a permanent text
146 //! \theInfo a string value
147 //! \theMsecs interval of msec milliseconds when the message will be hidden, if -1, it stays.
148 // If 0, default value is used, it is 3000
149 virtual void putInfo(const QString& theInfo, const int theMSecs = 0);
151 /// \return Workshop class instance
152 XGUI_Workshop* workshop() const { return myWorkshop; }
154 /// \brief Set flag about opened document state
155 void setIsOpened(bool theOpened) { myIsOpened = theOpened; }
157 virtual void updateModuleVisibilityState();
160 /// \brief The method is redefined to connect to the study viewer before the data
161 /// model is filled by opened file. This file open will flush redisplay signals for,
162 /// objects which should be visualized
163 //virtual void connectToStudy(CAM_Study* theStudy);
165 /// \brief The method is called on the module activation
166 /// \param theStudy current study
167 virtual bool activateModule(SUIT_Study* theStudy);
169 /// \brief The method is called on the module activation
170 /// \param theStudy current study
171 virtual bool deactivateModule(SUIT_Study* theStudy);
174 /// Redefinition of virtual function
175 /// \param theMgr view manager
176 virtual void onViewManagerAdded(SUIT_ViewManager* theMgr);
178 /// Redefinition of virtual function
179 /// \param theMgr view manager
180 virtual void onViewManagerRemoved(SUIT_ViewManager* theMgr);
182 /// Set preferences to default
183 void onDefaultPreferences();
185 /// Hide object browser if it was created during loading script
186 void onScriptLoaded();
188 /// Save application functionality with additional processing of aborting the current operation
189 void onSaveDocByShaper();
191 /// Save application functionality with additional processing of aborting the current operation
192 void onSaveAsDocByShaper();
194 /// Obtains the current application and updates its actions
195 void onUpdateCommandStatus();
198 /// Create data model
199 CAM_DataModel* createDataModel();
201 /// Create popup menu manager
202 virtual QtxPopupMgr* popupMgr();
204 /// Abort all operations
205 virtual bool abortAllOperations();
208 void onWhatIs(bool isToggled);
211 /// Create selector for OCC Viewer
212 /// \param theMgr view manager
213 SHAPERGUI_OCCSelector* createSelector(SUIT_ViewManager* theMgr);
215 /// List of registered actions
216 QStringList myActionsList;
218 /// List of registered nested actions
219 QStringList myNestedActionsList;
221 /// Reference to workshop
222 XGUI_Workshop* myWorkshop;
224 /// OCC viewer selector instance
225 SHAPERGUI_OCCSelector* mySelector;
227 /// Proxy viewer for connection to OCC Viewer in SALOME
228 SHAPERGUI_SalomeViewer* myProxyViewer;
230 /// Map of feature kind to a container of XML properties for the feature
231 QMap<QString, std::shared_ptr<Config_FeatureMessage> > myFeaturesInfo;
233 /// Flag of opened document state
236 // the next parameters should be restored after this module deactivation
238 /// The application value of the preferences parameter
239 bool myIsStorePositions;
241 /// The application value
242 bool myIsEditEnabled;
245 QtxPopupMgr* myPopupMgr;
247 QAction* myWhatIsAction;
249 bool myIsInspectionVisible;
250 QDockWidget* myInspectionPanel;