1 // Copyright (C) 2014-20xx CEA/DEN, EDF R&D
3 // File: ModuleBase_WidgetValidated.h
4 // Created: 12 Mar 2015
5 // Author: Natalia ERMOLAEVA
8 #ifndef MODULEBASE_WIDGETVALIDATED_H_
9 #define MODULEBASE_WIDGETVALIDATED_H_
11 #include <ModuleBase.h>
12 #include <ModuleBase_ModelWidget.h>
14 #include <GeomAPI_Shape.h>
15 #include <GeomAPI_AISObject.h>
16 #include <ModelAPI_Object.h>
18 #include <SelectMgr_ListOfFilter.hxx>
23 class ModuleBase_IWorkshop;
24 class ModuleBase_ISelection;
25 class ModelAPI_Validator;
26 class Config_WidgetAPI;
27 class Handle_SelectMgr_EntityOwner;
31 * Implementation of widget with validators and filters processing.
33 class MODULEBASE_EXPORT ModuleBase_WidgetValidated : public ModuleBase_ModelWidget
38 /// \param theParent the parent object
39 /// \param theWorkshop a reference to workshop
40 /// \param theData the widget configuation. The attribute of the model widget is obtained from
41 /// \param theParentId is Id of a parent of the current attribute
42 ModuleBase_WidgetValidated(QWidget* theParent,
43 ModuleBase_IWorkshop* theWorkshop,
44 const Config_WidgetAPI* theData,
45 const std::string& theParentId);
46 virtual ~ModuleBase_WidgetValidated();
48 /// Checks whether all active viewer filters validate the presentation
49 /// \param thePrs a selected presentation in the view
50 /// \return a boolean value
51 bool isValidInFilters(const ModuleBase_ViewerPrs& thePrs);
53 /// Checks all widget validator if the owner is valid
54 /// \param theValue a selected presentation in the view
55 /// \return a boolean value
56 bool isValidSelection(const ModuleBase_ViewerPrs& theValue);
58 /// Set the given wrapped value to the current widget
59 /// This value should be processed in the widget according to the needs
60 /// The method is called by the current operation to process the operation preselection.
61 /// It is redefined to check the value validity and if it is, fill the attribute with by value
62 /// \param theValues the wrapped selection values
63 /// \param theToValidate a flag on validation of the values
64 virtual bool setSelection(QList<ModuleBase_ViewerPrs>& theValues,
65 const bool theToValidate);
67 //! Returns data object by AIS
68 ObjectPtr findPresentedObject(const AISObjectPtr& theAIS) const;
70 /// It obtains selection filters from the workshop and activates them in the active viewer
71 /// \param toActivate a flag about activation or deactivation the filters
72 void activateFilters(const bool toActivate);
75 /// Creates a backup of the current values of the attribute
76 /// It should be realized in the specific widget because of different
77 /// parameters of the current attribute
78 virtual void storeAttributeValue();
80 /// Creates a backup of the current values of the attribute
81 /// It should be realized in the specific widget because of different
82 /// parameters of the current attribute
83 /// \param theValid a boolean flag, if restore happens for valid parameters
84 virtual void restoreAttributeValue(const bool theValid);
86 /// Checks the widget validity. By default, it returns true.
87 /// \param thePrs a selected presentation in the view
88 /// \return a boolean value
89 virtual bool isValidSelectionCustom(const ModuleBase_ViewerPrs& thePrs);
91 /// Fills the attribute with the value of the selected owner
92 /// \param thePrs a selected owner
93 virtual bool setSelectionCustom(const ModuleBase_ViewerPrs& thePrs) = 0;
95 /// Checks the current attibute in all attribute validators
96 // \return true if all validators return that the attribute is valid
97 bool isValidAttribute() const;
99 /// Returns true if the workshop validator filter has been already activated
100 /// \return boolean value
101 bool isFilterActivated() const;
103 /// Gets the validity state of the presentation in an internal map. Returns true if the valid state of value is stored
104 /// \param theValue a viewer presentation
105 /// \param theValid a valid state
106 bool getValidState(const ModuleBase_ViewerPrs& theValue, bool& theValid);
108 /// Store the validity state of the presentation in an internal map
109 /// \param theValue a viewer presentation
110 /// \param theValid a valid state
111 void storeValidState(const ModuleBase_ViewerPrs& theValue, const bool theValid);
113 /// Removes all presentations from internal maps.
114 void clearValidState();
116 /// Returns a list of selected presentations in the viewer and object browser
117 /// The presentations from the object browser are filtered by the AIS context filters
118 /// \return a list of presentations
119 QList<ModuleBase_ViewerPrs> getFilteredSelected();
121 /// Applies AIS context filters to the parameter list. The not approved presentations are
122 /// removed from the parameters.
123 /// \param theValues a list of presentations.
124 void filterPresentations(QList<ModuleBase_ViewerPrs>& theValues);
127 /// Reference to workshop
128 ModuleBase_IWorkshop* myWorkshop;
130 /// The widget is in validation mode: store is performed, restore is not
134 ObjectPtr myPresentedObject; /// back up of the filtered object
135 QList<ModuleBase_ViewerPrs> myValidPrs;
136 QList<ModuleBase_ViewerPrs> myInvalidPrs;
139 #endif /* MODULEBASE_WIDGETVALIDATED_H_ */