Salome HOME
minor corrections for correct compilation
[modules/gui.git] / src / SalomeApp / SalomeApp_ListView.cxx
index af9b7c5c09cd3a7ccd48112786e785a256ccdba8..6f3bd20e116ba503b68e05edb16bfe51d19f7de9 100644 (file)
@@ -1,4 +1,4 @@
-//  SALOME SalomeApp 
+//  SALOME SalomeApp
 //
 //  Copyright (C) 2005  CEA/DEN, EDF R&D
 //
@@ -33,10 +33,10 @@ using namespace std;
 
 //================================================================
 // Function : computeEditGeometry
-// Purpose  : static function - used for resizing editing widget
+/*! Purpose  : static function - used for resizing editing widget*/
 //================================================================
 void computeEditGeometry(SalomeApp_ListViewItem* theItem,
-                         SalomeApp_EntityEdit*   theWidget)  
+                         SalomeApp_EntityEdit*   theWidget)
 {
   if (!theItem)
     return;
@@ -44,7 +44,7 @@ void computeEditGeometry(SalomeApp_ListViewItem* theItem,
   int anEditColumn = theItem->getEditedColumn();
   if (anEditColumn < 0)
     return;
-  
+
   int aX = 0, aY = 0, aW = 0, aH = 0;
 
   QRect aRect = aListView->itemRect(theItem);
@@ -63,10 +63,10 @@ void computeEditGeometry(SalomeApp_ListViewItem* theItem,
 
 //================================================================
 // Function : SalomeApp_ListView::SalomeApp_ListView
-// Purpose  : constructor
+/*! Purpose  : constructor*/
 //================================================================
-SalomeApp_ListView::SalomeApp_ListView(QWidget *parent) :
-QListView(parent) 
+SalomeApp_ListView::SalomeApp_ListView( QWidget* parent )
+: QtxListView( parent )
 {
   myMouseEnabled = true;
   myEditingEnabled = false;
@@ -82,17 +82,17 @@ QListView(parent)
 
   viewport()->installEventFilter(this);
 
-  connect(this, SIGNAL(selectionChanged()), 
+  connect(this, SIGNAL(selectionChanged()),
          this, SLOT(onSelectionChanged()));
-  connect(header(), SIGNAL(sizeChange(int, int, int)), 
+  connect(header(), SIGNAL(sizeChange(int, int, int)),
          this,     SLOT(onHeaderSizeChange(int, int, int)));
 }
 
 //================================================================
 // Function : SalomeApp_ListView::~SalomeApp_ListView
-// Purpose  : destructor
+/*! Purpose  : destructor*/
 //================================================================
-SalomeApp_ListView::~SalomeApp_ListView() 
+SalomeApp_ListView::~SalomeApp_ListView()
 {
   if (myEdit) {
     delete myEdit;
@@ -103,9 +103,9 @@ SalomeApp_ListView::~SalomeApp_ListView()
 
 //================================================================
 // Function : SalomeApp_ListView::updateViewer
-// Purpose  : updates all data viewer
+/*! Purpose  : updates all data viewer*/
 //================================================================
-void SalomeApp_ListView::updateViewer() 
+void SalomeApp_ListView::updateViewer()
 {
   // temporary disconnecting selection changed SIGNAL
   blockSignals(true);
@@ -120,9 +120,9 @@ void SalomeApp_ListView::updateViewer()
 
 //================================================================
 // Function : SalomeApp_ListView::updateSelected
-// Purpose  : updates currently selected item(s)
+/*! Purpose  : updates currently selected item(s)*/
 //================================================================
-void SalomeApp_ListView::updateSelected() 
+void SalomeApp_ListView::updateSelected()
 {
   // temporary disconnecting selection changed SIGNAL
   blockSignals(true);
@@ -137,7 +137,7 @@ void SalomeApp_ListView::updateSelected()
 
 //================================================================
 // Function : SalomeApp_ListView::popupClientType
-// Purpose  : returns popup client type
+/*! Purpose  : returns popup client type*/
 //================================================================
 QString SalomeApp_ListView::popupClientType() const
 {
@@ -146,9 +146,9 @@ QString SalomeApp_ListView::popupClientType() const
 
 //================================================================
 // Function : SalomeApp_ListView::contextMenuPopup
-// Purpose  : fills popup menu with items
+/*! Purpose  : fills popup menu with items*/
 //================================================================
-void SalomeApp_ListView::contextMenuPopup( QPopupMenu* aPopup ) 
+void SalomeApp_ListView::contextMenuPopup( QPopupMenu* aPopup )
 {
   if (aPopup) {
     // add items here...
@@ -157,9 +157,9 @@ void SalomeApp_ListView::contextMenuPopup( QPopupMenu* aPopup )
 
 //================================================================
 // Function : SalomeApp_ListView::clear
-// Purpose  : clears view
+/*! Purpose  : clears view*/
 //================================================================
-void SalomeApp_ListView::clear() 
+void SalomeApp_ListView::clear()
 {
   if (myEdit) {
     delete myEdit;
@@ -171,9 +171,9 @@ void SalomeApp_ListView::clear()
 
 //================================================================
 // Function : SalomeApp_ListView::isMouseEnabled
-// Purpose  : returms true if mouse events are enabled
+/*! Purpose  : returms true if mouse events are enabled*/
 //================================================================
-bool SalomeApp_ListView::isMouseEnabled() 
+bool SalomeApp_ListView::isMouseEnabled()
 {
   return myMouseEnabled;
 }
@@ -182,16 +182,16 @@ bool SalomeApp_ListView::isMouseEnabled()
 // Function : SalomeApp_ListView::enableMouse
 // Purpose  : enabled/disables mouse events (excluding MouseMove)
 //================================================================
-void SalomeApp_ListView::enableMouse(bool enable) 
+void SalomeApp_ListView::enableMouse(bool enable)
 {
   myMouseEnabled = enable;
 }
 
 //================================================================
 // Function : SalomeApp_ListView::eventFilter
-// Purpose  : event filter
+/*! Purpose  : event filter*/
 //================================================================
-bool SalomeApp_ListView::eventFilter(QObject* object, QEvent* event) 
+bool SalomeApp_ListView::eventFilter(QObject* object, QEvent* event)
 {
   if (object == viewport() &&
        (event->type() == QEvent::MouseButtonPress   ||
@@ -205,9 +205,9 @@ bool SalomeApp_ListView::eventFilter(QObject* object, QEvent* event)
 
 //================================================================
 // Function : SalomeApp_ListView::enableEditing
-// Purpose  : setting editing of items availbale/not available
+/*! Purpose  : setting editing of items availbale/not available*/
 //================================================================
-void SalomeApp_ListView::enableEditing(bool theFlag) 
+void SalomeApp_ListView::enableEditing(bool theFlag)
 {
   myEditingEnabled = theFlag;
   if (!myEditingEnabled) {
@@ -221,27 +221,27 @@ void SalomeApp_ListView::enableEditing(bool theFlag)
 
 //================================================================
 // Function : SalomeApp_ListView::isEnableEditing
-// Purpose  : says if editing is enabled
+/*! Purpose  : says if editing is enabled*/
 //================================================================
-bool SalomeApp_ListView::isEnableEditing() 
+bool SalomeApp_ListView::isEnableEditing()
 {
   return myEditingEnabled;
 }
 
 //================================================================
 // Function : SalomeApp_ListView::accept
-// Purpose  : calls finishEditing(true)...
+/*! Purpose  : calls finishEditing(true)...*/
 //================================================================
-void SalomeApp_ListView::accept() 
+void SalomeApp_ListView::accept()
 {
   finishEditing(true);
 }
 
 //================================================================
 // Function : QAD_ListView::onSelectionChanged
-// Purpose  : slot, called when selection changed in List Viewer
+/*! Purpose  : slot, called when selection changed in List Viewer*/
 //================================================================
-void SalomeApp_ListView::onSelectionChanged() 
+void SalomeApp_ListView::onSelectionChanged()
 {
   if (myEdit) {
     finishEditing(true);
@@ -252,7 +252,7 @@ void SalomeApp_ListView::onSelectionChanged()
       updateContents();
     }
     myEditedItem = 0;
-  } 
+  }
   // editing is allowed in Single Selection Mode only
   if (selectionMode() != Single || !isEnableEditing())
     return;
@@ -273,9 +273,9 @@ void SalomeApp_ListView::onSelectionChanged()
 
 //================================================================
 // Function : SalomeApp_ListView::resizeEvent
-// Purpose  : called when Data Viewer is resized
+/*! Purpose  : called when Data Viewer is resized*/
 //================================================================
-void SalomeApp_ListView::resizeEvent( QResizeEvent * e) 
+void SalomeApp_ListView::resizeEvent( QResizeEvent * e)
 {
   QListView::resizeEvent(e);
   int aW = columnWidth(columns()-1);
@@ -287,9 +287,9 @@ void SalomeApp_ListView::resizeEvent( QResizeEvent * e)
 
 //================================================================
 // Function : SalomeApp_ListView::onHeaderSizeChange
-// Purpose  : slot, called when columns sizes are changed
+/*! Purpose  : slot, called when columns sizes are changed*/
 //================================================================
-void SalomeApp_ListView::onHeaderSizeChange(int, int, int) 
+void SalomeApp_ListView::onHeaderSizeChange(int, int, int)
 {
   int aW = columnWidth(columns()-1);
   int aX = header()->sectionPos(columns()-1);
@@ -299,9 +299,9 @@ void SalomeApp_ListView::onHeaderSizeChange(int, int, int)
 
 //================================================================
 // Function : SalomeApp_ListView::viewportPaintEvent
-// Purpose  : handler for paint event
+/*! Purpose  : handler for paint event*/
 //================================================================
-void SalomeApp_ListView::viewportPaintEvent(QPaintEvent* e) 
+void SalomeApp_ListView::viewportPaintEvent(QPaintEvent* e)
 {
   QListView::viewportPaintEvent(e);
   if (myEditedItem && myEdit) {
@@ -311,27 +311,27 @@ void SalomeApp_ListView::viewportPaintEvent(QPaintEvent* e)
 
 //================================================================
 // Function : SalomeApp_ListView::onEditOk
-// Purpose  : called when user finishes in editing of item
+/*! Purpose  : called when user finishes in editing of item*/
 //================================================================
-void SalomeApp_ListView::onEditOk() 
+void SalomeApp_ListView::onEditOk()
 {
   finishEditing(true);
 }
-  
+
 //================================================================
 // Function : SalomeApp_ListView::onEditCancel
-// Purpose  : called when user cancels item editing
+/*! Purpose  : called when user cancels item editing*/
 //================================================================
-void SalomeApp_ListView::onEditCancel() 
+void SalomeApp_ListView::onEditCancel()
 {
   finishEditing(false);
 }
 
 //================================================================
 // Function : SalomeApp_ListView::finishEditing
-// Purpose  : finishes editing of entity
+/*! Purpose  : finishes editing of entity*/
 //================================================================
-UpdateType SalomeApp_ListView::finishEditing(bool ok) 
+UpdateType SalomeApp_ListView::finishEditing(bool ok)
 {
   UpdateType aNeedsUpdate = utCancel;
   if (myEditedItem && myEdit)
@@ -361,7 +361,7 @@ UpdateType SalomeApp_ListView::finishEditing(bool ok)
             SalomeApp_ListViewItem* aParent = (SalomeApp_ListViewItem*)(myEditedItem->parent());
             if (aParent)
               aParent->updateAllLevels();
-            else 
+            else
               myEditedItem->updateAllLevels();
           }
           break;
@@ -394,13 +394,14 @@ UpdateType SalomeApp_ListView::finishEditing(bool ok)
 
 //================================================================
 // Function : SalomeApp_ListView::tip
-// Purpose  : gets current tooltip for list view
-//            returns valid rect in success
+/*! Purpose  : gets current tooltip for list view
+ * \retval valid rect in success
+ */
 //================================================================
-QRect SalomeApp_ListView::tip(QPoint aPos, 
-                       QString& aText, 
-                       QRect& dspRect, 
-                       QFont& dspFnt) const 
+QRect SalomeApp_ListView::tip(QPoint aPos,
+                       QString& aText,
+                       QRect& dspRect,
+                       QFont& dspFnt) const
 {
   QRect result( -1, -1, -1, -1 );
   SalomeApp_ListViewItem* aItem = (SalomeApp_ListViewItem*)itemAt( aPos );
@@ -410,7 +411,7 @@ QRect SalomeApp_ListView::tip(QPoint aPos,
       QRect aTextRect = aItem->textRect(i);
       if ( !aItem->text(i).isEmpty() &&
           ( aItemRect.width()  > header()->sectionSize(i) ||
-            aTextRect.left()   < 0 || 
+            aTextRect.left()   < 0 ||
              aTextRect.top()    < 0 ||
              aTextRect.right()  > viewport()->width() ||
              aTextRect.bottom() > viewport()->height() ) ) {
@@ -419,7 +420,7 @@ QRect SalomeApp_ListView::tip(QPoint aPos,
        dspRect = aItem->tipRect();
        dspFnt  = font();
         if (dspRect.isValid()) {
-          result  = QRect(QPoint(0, aItemRect.top()), 
+          result  = QRect(QPoint(0, aItemRect.top()),
                           QSize(viewport()->width(), aItemRect.height()));
         }
       }
@@ -434,33 +435,33 @@ QRect SalomeApp_ListView::tip(QPoint aPos,
 
 //================================================================
 // Function : SalomeApp_ListViewItem::SalomeApp_ListViewItem
-// Purpose  : constructor
+/*! Purpose  : constructor*/
 //================================================================
 SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListView* parent) :
-QListViewItem( parent ) 
+QListViewItem( parent )
 {
   init();
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::SalomeApp_ListViewItem
-// Purpose  : constructor
+/*! Purpose  : constructor*/
 //================================================================
-SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListView*     parent, 
+SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListView*     parent,
                                   SalomeApp_ListViewItem* after) :
-QListViewItem( parent, after ) 
+QListViewItem( parent, after )
 {
   init();
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::SalomeApp_ListViewItem
-// Purpose  : constructor
+/*! Purpose  : constructor*/
 //================================================================
-SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListView*     parent, 
+SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListView*     parent,
                                   const QString&    theName,
                                   const bool        theEditable) :
-QListViewItem(parent, theName) 
+QListViewItem(parent, theName)
 {
   init();
   setEditable(theEditable);
@@ -468,13 +469,13 @@ QListViewItem(parent, theName)
 
 //================================================================
 // Function : SalomeApp_ListViewItem::SalomeApp_ListViewItem
-// Purpose  : constructor
+/*! Purpose  : constructor*/
 //================================================================
-SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListView*     parent, 
+SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListView*     parent,
                                   const QString&    theName,
                                   const QString&    theValue,
                                   const bool        theEditable) :
-QListViewItem(parent, theName, theValue) 
+QListViewItem(parent, theName, theValue)
 {
   init();
   setEditable(theEditable);
@@ -482,9 +483,9 @@ QListViewItem(parent, theName, theValue)
 
 //================================================================
 // Function : SalomeApp_ListViewItem::SalomeApp_ListViewItem
-// Purpose  : constructor
+/*! Purpose  : constructor*/
 //================================================================
-SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListViewItem* parent, 
+SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListViewItem* parent,
                                   const QString&    theName,
                                   const bool        theEditable) :
 QListViewItem(parent, theName)
@@ -495,10 +496,10 @@ QListViewItem(parent, theName)
 
 //================================================================
 // Function : SalomeApp_ListViewItem::SalomeApp_ListViewItem
-// Purpose  : constructor
+/*! Purpose  : constructor*/
 //================================================================
-SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListViewItem* parent, 
-                                  SalomeApp_ListViewItem* after, 
+SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListViewItem* parent,
+                                  SalomeApp_ListViewItem* after,
                                   const QString&    theName,
                                   const bool        theEditable) :
 QListViewItem(parent, after, theName)
@@ -509,10 +510,10 @@ QListViewItem(parent, after, theName)
 
 //================================================================
 // Function : SalomeApp_ListViewItem::SalomeApp_ListViewItem
-// Purpose  : constructor
+/*! Purpose  : constructor*/
 //================================================================
-SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListView*     parent, 
-                                  SalomeApp_ListViewItem* after, 
+SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListView*     parent,
+                                  SalomeApp_ListViewItem* after,
                                   const QString&    theName,
                                   const bool        theEditable) :
 QListViewItem(parent, after, theName)
@@ -524,9 +525,9 @@ QListViewItem(parent, after, theName)
 
 //================================================================
 // Function : SalomeApp_ListViewItem::SalomeApp_ListViewItem
-// Purpose  : constructor
+/*! Purpose  : constructor*/
 //================================================================
-SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListViewItem* parent, 
+SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListViewItem* parent,
                                   const QString&    theName,
                                   const QString&    theValue,
                                   const bool        theEditable) :
@@ -539,10 +540,10 @@ QListViewItem(parent, theName, theValue)
 
 //================================================================
 // Function : SalomeApp_ListViewItem::SalomeApp_ListViewItem
-// Purpose  : constructor
+/*! Purpose  : constructor*/
 //================================================================
-SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListViewItem* parent, 
-                                  SalomeApp_ListViewItem* after, 
+SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListViewItem* parent,
+                                  SalomeApp_ListViewItem* after,
                                   const QString&    theName,
                                   const QString&    theValue,
                                   const bool        theEditable) :
@@ -554,10 +555,10 @@ QListViewItem(parent, after, theName, theValue)
 
 //================================================================
 // Function : SalomeApp_ListViewItem::SalomeApp_ListViewItem
-// Purpose  : constructor
+/*! Purpose  : constructor*/
 //================================================================
-SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListView*     parent, 
-                                  SalomeApp_ListViewItem* after, 
+SalomeApp_ListViewItem::SalomeApp_ListViewItem(SalomeApp_ListView*     parent,
+                                  SalomeApp_ListViewItem* after,
                                   const QString&    theName,
                                   const QString&    theValue,
                                   const bool        theEditable) :
@@ -569,17 +570,17 @@ QListViewItem(parent, after, theName, theValue)
 
 //================================================================
 // Function : SalomeApp_ListViewItem::~SalomeApp_ListViewItem
-// Purpose  : destructor
+/*! Purpose  : destructor*/
 //================================================================
-SalomeApp_ListViewItem::~SalomeApp_ListViewItem() 
+SalomeApp_ListViewItem::~SalomeApp_ListViewItem()
 {
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::init
-// Purpose  : initialization
+/*! Purpose  : initialization*/
 //================================================================
-void SalomeApp_ListViewItem::init() 
+void SalomeApp_ListViewItem::init()
 {
   myEditable    = false;
   myAccepted    = true;
@@ -591,18 +592,18 @@ void SalomeApp_ListViewItem::init()
 
 //================================================================
 // Function : SalomeApp_ListViewItem::getName
-// Purpose  : as default returns text in the first column
+/*! Purpose  : as default returns text in the first column*/
 //================================================================
-QString SalomeApp_ListViewItem::getName() const 
+QString SalomeApp_ListViewItem::getName() const
 {
   return ( listView()->columns() > 0 ) ? text(0) : QString("");
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::setName
-// Purpose  : as default sets text in the first column
+/*! Purpose  : as default sets text in the first column*/
 //================================================================
-UpdateType SalomeApp_ListViewItem::setName(const QString& theName) 
+UpdateType SalomeApp_ListViewItem::setName(const QString& theName)
 {
   UpdateType aNeedsUpdate = utCancel;
   if (listView()->columns() > 0) {
@@ -614,18 +615,18 @@ UpdateType SalomeApp_ListViewItem::setName(const QString& theName)
 
 //================================================================
 // Function : SalomeApp_ListViewItem::getValue
-// Purpose  : as default returns text in the second column
+/*! Purpose  : as default returns text in the second column*/
 //================================================================
-QString SalomeApp_ListViewItem::getValue() const 
+QString SalomeApp_ListViewItem::getValue() const
 {
   return ( listView()->columns() > 1 ) ? text(1) : QString("");
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::setValue
-// Purpose  : as default sets text in the second column
+/*! Purpose  : as default sets text in the second column*/
 //================================================================
-UpdateType SalomeApp_ListViewItem::setValue(const QString& theValue) 
+UpdateType SalomeApp_ListViewItem::setValue(const QString& theValue)
 {
   UpdateType aNeedsUpdate = utCancel;
   if (listView()->columns() > 1) {
@@ -637,9 +638,9 @@ UpdateType SalomeApp_ListViewItem::setValue(const QString& theValue)
 
 //================================================================
 // Function : SalomeApp_ListViewItem::fullName
-// Purpose  : returns full path to the entity from the root
+/*! Purpose  : returns full path to the entity from the root*/
 //================================================================
-QString SalomeApp_ListViewItem::fullName() 
+QString SalomeApp_ListViewItem::fullName()
 {
   QString aFullName = getName();
   SalomeApp_ListViewItem* aParent = (SalomeApp_ListViewItem*)parent();
@@ -652,9 +653,9 @@ QString SalomeApp_ListViewItem::fullName()
 
 //================================================================
 // Function : SalomeApp_ListViewItem::openAllLevels
-// Purpose  : expands all entities beginning from this level
+/*! Purpose  : expands all entities beginning from this level*/
 //================================================================
-void SalomeApp_ListViewItem::openAllLevels() 
+void SalomeApp_ListViewItem::openAllLevels()
 {
   setOpen(true);
   SalomeApp_ListViewItem* aChild = (SalomeApp_ListViewItem*)firstChild();
@@ -666,9 +667,9 @@ void SalomeApp_ListViewItem::openAllLevels()
 
 //================================================================
 // Function : SalomeApp_ListViewItem::updateAllLevels
-// Purpose  : update all entites beginning from this level
+/*! Purpose  : update all entites beginning from this level*/
 //================================================================
-void SalomeApp_ListViewItem::updateAllLevels() 
+void SalomeApp_ListViewItem::updateAllLevels()
 {
   SalomeApp_ListViewItem* aChild = (SalomeApp_ListViewItem*)firstChild();
   while( aChild ) {
@@ -679,131 +680,144 @@ void SalomeApp_ListViewItem::updateAllLevels()
 
 //================================================================
 // Function : SalomeApp_EditBox::isEditable
-// Purpose  : return true if entity is editable
+/*! Purpose  : return true if entity is editable*/
 //================================================================
-bool SalomeApp_ListViewItem::isEditable() const 
+bool SalomeApp_ListViewItem::isEditable() const
 {
   return myEditable;
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::setEditable
-// Purpose  : sets editable flag fo the entity
+/*! Purpose  : sets editable flag fo the entity*/
 //================================================================
-void SalomeApp_ListViewItem::setEditable(bool theEditable) 
+void SalomeApp_ListViewItem::setEditable(bool theEditable)
 {
   myEditable = theEditable;
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::isAccepted
-// Purpose  : returns true if entitiy is accepted after editing
+/*! Purpose  : returns true if entitiy is accepted after editing*/
 //================================================================
-bool SalomeApp_ListViewItem::isAccepted() const 
+bool SalomeApp_ListViewItem::isAccepted() const
 {
   return myAccepted;
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::setAccepted
-// Purpose  : set entitiy accepted or not after editing
+/*! Purpose  : set entitiy accepted or not after editing*/
 //================================================================
-void SalomeApp_ListViewItem::setAccepted(bool theAccepted) 
+void SalomeApp_ListViewItem::setAccepted(bool theAccepted)
 {
   myAccepted = theAccepted;
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::getEditingType
-// Purpose  : returns type of edit control (0 - edit box, 1 - combo box, 
-//            2 - editable combo box),  default is edit box
+/*! Purpose  : 
+ * \retval type of edit control (default is edit box)
+ *     \li 0 - edit box
+ *     \li 1 - combo box
+ *     \li 2 - editable combo box
+ */
 //================================================================
-int SalomeApp_ListViewItem::getEditingType() 
+int SalomeApp_ListViewItem::getEditingType()
 {
   return myEditingType;
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::setEditingType
-// Purpose  : sets type of edit control (0 - edit box, 1 - combo box, 
-//            2 - editable combo box), negative value means none
+/*! Purpose  : 
+ * \retval type of edit control (negative value means none)
+ *     \li 0 - edit box
+ *     \li 1 - combo box
+ *     \li 2 - editable combo box
+ */
 //================================================================
-void SalomeApp_ListViewItem::setEditingType(const int type) 
+void SalomeApp_ListViewItem::setEditingType(const int type)
 {
   myEditingType = type;
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::getEditedColumn
-// Purpose  : returns edited column, default is last column
-//            negative value means there are no editable columns
+// Purpose  : 
+/*! \retval edited column, default is last column
+ *   negative value means there are no editable columns
+ */
 //================================================================
-int SalomeApp_ListViewItem::getEditedColumn() 
+int SalomeApp_ListViewItem::getEditedColumn()
 {
   return listView()->columns()-1;
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::getValueType
-// Purpose  : returns type of edited value (string, int, double)
-//            default is string
+// Purpose  : 
+/*!\retval type of edited value (string, int, double)
+ * default is string
+ */
 //================================================================
-int SalomeApp_ListViewItem::getValueType() 
+int SalomeApp_ListViewItem::getValueType()
 {
   return myValueType;
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::setValueType
-// Purpose  : sets type of edited value
+/*! Purpose  : sets type of edited value*/
 //================================================================
-void SalomeApp_ListViewItem::setValueType(const int valueType) 
+void SalomeApp_ListViewItem::setValueType(const int valueType)
 {
   myValueType = valueType;
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::getUserType
-// Purpose  : sets type of edited value
+/*! Purpose  : sets type of edited value*/
 //================================================================
-int SalomeApp_ListViewItem::getUserType() 
+int SalomeApp_ListViewItem::getUserType()
 {
   return myUserType;
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::setUserType
-// Purpose  : sets type of edited value
+/*! Purpose  : sets type of edited value*/
 //================================================================
-void SalomeApp_ListViewItem::setUserType(const int userType) 
+void SalomeApp_ListViewItem::setUserType(const int userType)
 {
   myUserType = userType;
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::getButtons
-// Purpose  : returns buttons for editing widget (Apply (V), Cancel (X))
-//            default is both buttons
+/*! Purpose  : returns buttons for editing widget (Apply (V), Cancel (X))
+ * default is both buttons
+ */
 //================================================================
-int SalomeApp_ListViewItem::getButtons() 
+int SalomeApp_ListViewItem::getButtons()
 {
   return myButtons;
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::getButtons
-// Purpose  : sets buttons for editing widget (Apply (V), Cancel (X))
+/*! Purpose  : sets buttons for editing widget (Apply (V), Cancel (X))*/
 //================================================================
-void SalomeApp_ListViewItem::setButtons(const int buttons) 
+void SalomeApp_ListViewItem::setButtons(const int buttons)
 {
   myButtons = buttons;
 }
 
 //================================================================
 // Function : SalomeApp_ListViewItem::startEditing
-// Purpose  : creates control for editing and fills it with values
+/*! Purpose  : creates control for editing and fills it with values*/
 //================================================================
-SalomeApp_EntityEdit* SalomeApp_ListViewItem::startEditing() 
+SalomeApp_EntityEdit* SalomeApp_ListViewItem::startEditing()
 {
   SalomeApp_EntityEdit* aWidget = 0;
   QListView* aListView = listView();
@@ -816,9 +830,9 @@ SalomeApp_EntityEdit* SalomeApp_ListViewItem::startEditing()
     int anEditColumn = getEditedColumn();
     if (anEditColumn < 0 || anEditType < 0)
       return 0;
-    aWidget = new SalomeApp_EntityEdit(aListView->viewport(), 
-                                 anEditType, 
-                                aValueType, 
+    aWidget = new SalomeApp_EntityEdit(aListView->viewport(),
+                                 anEditType,
+                                aValueType,
                                 aButtons & SalomeApp_EntityEdit::btApply,
                                 aButtons & SalomeApp_EntityEdit::btCancel);
     computeEditGeometry(this, aWidget);
@@ -830,9 +844,9 @@ SalomeApp_EntityEdit* SalomeApp_ListViewItem::startEditing()
 
 //================================================================
 // Function : SalomeApp_ListViewItem::fillWidgetWithValues
-// Purpose  : fills widget with initial values (list or single value)
+/*! Purpose  : fills widget with initial values (list or single value)*/
 //================================================================
-void SalomeApp_ListViewItem::fillWidgetWithValues(SalomeApp_EntityEdit* theWidget) 
+void SalomeApp_ListViewItem::fillWidgetWithValues(SalomeApp_EntityEdit* theWidget)
 {
   int anEditColumn = getEditedColumn();
   if (theWidget && anEditColumn >= 0 && !text(anEditColumn).isEmpty())
@@ -841,9 +855,9 @@ void SalomeApp_ListViewItem::fillWidgetWithValues(SalomeApp_EntityEdit* theWidge
 
 //================================================================
 // Function : SalomeApp_ListViewItem::finishEditing
-// Purpose  : finishes editing of entity
+/*! Purpose  : finishes editing of entity*/
 //================================================================
-UpdateType SalomeApp_ListViewItem::finishEditing(SalomeApp_EntityEdit* theWidget) 
+UpdateType SalomeApp_ListViewItem::finishEditing(SalomeApp_EntityEdit* theWidget)
 {
   UpdateType aNeedsUpdate = utCancel;
   try {
@@ -856,10 +870,10 @@ UpdateType SalomeApp_ListViewItem::finishEditing(SalomeApp_EntityEdit* theWidget
       case 1:
         aNeedsUpdate = setValue(theWidget->getText());
         break;
-      default: 
+      default:
         break;
       }
-    } 
+    }
   }
   catch (...) {
     MESSAGE( "System error has been caught - SalomeApp_ListViewItem::finishEditing" )
@@ -869,9 +883,9 @@ UpdateType SalomeApp_ListViewItem::finishEditing(SalomeApp_EntityEdit* theWidget
 
 //================================================================
 // Function : SalomeApp_ListViewItem::tipRect
-// Purpose  : calculates rectangle which should contain item's tip
+/*! Purpose  : calculates rectangle which should contain item's tip*/
 //================================================================
-QRect SalomeApp_ListViewItem::tipRect() 
+QRect SalomeApp_ListViewItem::tipRect()
 {
   QRect aRect = QRect(-1, -1, -1, -1);
   QRect aItemRect = listView()->itemRect(this);
@@ -884,9 +898,9 @@ QRect SalomeApp_ListViewItem::tipRect()
     QFont aFont(listView()->font());
     QFontMetrics fm(aFont);
     int iw = fm.width(aTip);
-    aRect = QRect(QPoint(aRect0.x() < 0 ? 0 : aRect0.x(), 
-                         aRect0.y()), 
-                  QSize (iw,         
+    aRect = QRect(QPoint(aRect0.x() < 0 ? 0 : aRect0.x(),
+                         aRect0.y()),
+                  QSize (iw,
                          aRect0.height()));
   }
   return aRect;
@@ -894,9 +908,9 @@ QRect SalomeApp_ListViewItem::tipRect()
 
 //================================================================
 // Function : SalomeApp_ListViewItem::tipText
-// Purpose  : returns text for tooltip
+/*! Purpose  : returns text for tooltip*/
 //================================================================
-QString SalomeApp_ListViewItem::tipText() 
+QString SalomeApp_ListViewItem::tipText()
 {
   QString aText = getName();
   if (!getValue().isEmpty())
@@ -906,28 +920,28 @@ QString SalomeApp_ListViewItem::tipText()
 
 //================================================================
 // Function : SalomeApp_ListViewItem::textRect
-// Purpose  : calculates rect of item text in viewport coordinates
+/*! Purpose  : calculates rect of item text in viewport coordinates*/
 //================================================================
 QRect SalomeApp_ListViewItem::textRect(const int column) const
 {
   QRect aItemRect = listView()->itemRect( this );
   if ( !aItemRect.isValid() )
     return aItemRect;
-  
+
   QFont aFont(listView()->font());
   QFontMetrics fm(aFont);
-  
-  int decorWidth  = ( listView()->rootIsDecorated() ) ? 
+
+  int decorWidth  = ( listView()->rootIsDecorated() ) ?
                     ( listView()->treeStepSize() * (depth() + 1) ) :
                     ( listView()->treeStepSize() *  depth() );
-  int pixmapWidth = ( pixmap(column) ) ? 
-                      pixmap(column)->width() +  listView()->itemMargin() * 2 : 
+  int pixmapWidth = ( pixmap(column) ) ?
+                      pixmap(column)->width() +  listView()->itemMargin() * 2 :
                       listView()->itemMargin();
   int prevWidth = 0;
   for (int i = 0; i < column; i++)
     prevWidth += listView()->header()->sectionSize(i);
   int ix = prevWidth   +
-           pixmapWidth + 
+           pixmapWidth +
            ((column == 0) ? decorWidth : 0);
   int iy = aItemRect.y();
   int iw = fm.width(text(column));
@@ -944,31 +958,31 @@ QRect SalomeApp_ListViewItem::textRect(const int column) const
 
 //================================================================
 // Function : SalomeApp_ListViewItem::itemRect
-// Purpose  : calculates rect of item data in viewport coordinates
+/*! Purpose  : calculates rect of item data in viewport coordinates*/
 //================================================================
 QRect SalomeApp_ListViewItem::itemRect(const int column) const
 {
   QRect aItemRect = listView()->itemRect( this );
   if ( !aItemRect.isValid() )
     return aItemRect;
-  
+
   QFont aFont(listView()->font());
   QFontMetrics fm(aFont);
-  
-  int decorWidth  = ( listView()->rootIsDecorated() ) ? 
+
+  int decorWidth  = ( listView()->rootIsDecorated() ) ?
                     ( listView()->treeStepSize() * (depth() + 1) ) :
                     ( listView()->treeStepSize() *  depth() );
-  int pixmapWidth = ( pixmap(column) ) ? 
-                      pixmap(column)->width() +  listView()->itemMargin() * 2 : 
+  int pixmapWidth = ( pixmap(column) ) ?
+                      pixmap(column)->width() +  listView()->itemMargin() * 2 :
                       0;
   int prevWidth = 0;
   for (int i = 0; i < column; i++)
     prevWidth += listView()->header()->sectionSize(i);
   int ix = prevWidth;
   int iy = aItemRect.y();
-  int iw = pixmapWidth + 
-           listView()->itemMargin() * 2 + 
-           ((column == 0) ? decorWidth : 0) + 
+  int iw = pixmapWidth +
+           listView()->itemMargin() * 2 +
+           ((column == 0) ? decorWidth : 0) +
            fm.width(text(column));
   int ih = aItemRect.height();
   ix -= listView()->contentsX();
@@ -983,18 +997,18 @@ QRect SalomeApp_ListViewItem::itemRect(const int column) const
 
 //================================================================
 // Function : SalomeApp_EditBox::SalomeApp_EditBox
-// Purpose  : constructor
+/*! Purpose  : constructor*/
 //================================================================
 SalomeApp_EditBox::SalomeApp_EditBox(QWidget* parent) :
-QLineEdit(parent) 
+QLineEdit(parent)
 {
 }
 
 //================================================================
 // Function : SalomeApp_EditBox::keyPressEvent
-// Purpose  : event filter for key pressing
+/*! Purpose  : event filter for key pressing*/
 //================================================================
-void SalomeApp_EditBox::keyPressEvent( QKeyEvent *e ) 
+void SalomeApp_EditBox::keyPressEvent( QKeyEvent *e )
 {
   if ( e->key() == Key_Escape )
     emit escapePressed();
@@ -1009,20 +1023,20 @@ void SalomeApp_EditBox::keyPressEvent( QKeyEvent *e )
 
 //================================================================
 // Function : SalomeApp_ComboBox::SalomeApp_ComboBox
-// Purpose  : constructor
+/*! Purpose  : constructor*/
 //================================================================
 SalomeApp_ComboBox::SalomeApp_ComboBox(bool rw, QWidget* parent, const char* name) :
-QComboBox(rw, parent, name) 
+QComboBox(rw, parent, name)
 {
 }
 
 //================================================================
 // Function : SalomeApp_ComboBox::findItem
-// Purpose  : searches item in list and returns its index
+/*! Purpose  : searches item in list and returns its index*/
 //================================================================
-int SalomeApp_ComboBox::findItem(const QString& theText) 
+int SalomeApp_ComboBox::findItem(const QString& theText)
 {
-  for (int i = 0; i < count(); i++) 
+  for (int i = 0; i < count(); i++)
     if (text(i) == theText)
       return i;
   return -1;
@@ -1030,10 +1044,10 @@ int SalomeApp_ComboBox::findItem(const QString& theText)
 
 //================================================================
 // Function : SalomeApp_ComboBox::insertItem
-// Purpose  : adds item in combo box
+/*! Purpose  : adds item in combo box*/
 //================================================================
 void SalomeApp_ComboBox::insertItem(const QString& theValue,
-                             int            theIndex) 
+                             int            theIndex)
 {
   if (duplicatesEnabled() || findItem(theValue) < 0)
     QComboBox::insertItem(theValue, theIndex);
@@ -1041,9 +1055,9 @@ void SalomeApp_ComboBox::insertItem(const QString& theValue,
 
 //================================================================
 // Function : SalomeApp_ComboBox::insertList
-// Purpose  : adds list of items in combo box
+/*! Purpose  : adds list of items in combo box*/
 //================================================================
-void SalomeApp_ComboBox::insertList(const QStringList& theList) 
+void SalomeApp_ComboBox::insertList(const QStringList& theList)
 {
   for (unsigned i = 0; i < theList.count(); i++)
     insertItem(theList[i]);
@@ -1051,9 +1065,9 @@ void SalomeApp_ComboBox::insertList(const QStringList& theList)
 
 //================================================================
 // Function : SalomeApp_ComboBox::insertItem
-// Purpose  : adds item in combo box
+/*! Purpose  : adds item in combo box*/
 //================================================================
-void SalomeApp_ComboBox::insertItem(const int theValue) 
+void SalomeApp_ComboBox::insertItem(const int theValue)
 {
   int aNum;
   bool bOk;
@@ -1071,9 +1085,9 @@ void SalomeApp_ComboBox::insertItem(const int theValue)
 
 //================================================================
 // Function : SalomeApp_ComboBox::insertList
-// Purpose  : adds list of items in combo box
+/*! Purpose  : adds list of items in combo box*/
 //================================================================
-void SalomeApp_ComboBox::insertList(const TColStd_ListOfInteger& theList) 
+void SalomeApp_ComboBox::insertList(const TColStd_ListOfInteger& theList)
 {
   for (TColStd_ListIteratorOfListOfInteger aIter(theList); aIter.More(); aIter.Next())
     insertItem(aIter.Value());
@@ -1081,9 +1095,9 @@ void SalomeApp_ComboBox::insertList(const TColStd_ListOfInteger& theList)
 
 //================================================================
 // Function : SalomeApp_ComboBox::insertItem
-// Purpose  : adds item in combo box
+/*! Purpose  : adds item in combo box*/
 //================================================================
-void SalomeApp_ComboBox::insertItem(const double theValue) 
+void SalomeApp_ComboBox::insertItem(const double theValue)
 {
   double aNum;
   bool bOk;
@@ -1101,9 +1115,9 @@ void SalomeApp_ComboBox::insertItem(const double theValue)
 
 //================================================================
 // Function : SalomeApp_ComboBox::insertList
-// Purpose  : adds list of items in combo box
+/*! Purpose  : adds list of items in combo box*/
 //================================================================
-void SalomeApp_ComboBox::insertList(const TColStd_ListOfReal& theList) 
+void SalomeApp_ComboBox::insertList(const TColStd_ListOfReal& theList)
 {
   for (TColStd_ListIteratorOfListOfReal aIter(theList); aIter.More(); aIter.Next())
     insertItem(aIter.Value());
@@ -1120,18 +1134,18 @@ void SalomeApp_ComboBox::insertList(const TColStd_ListOfReal& theList)
 
 //================================================================
 // Function : SalomeApp_EntityEdit::SalomeApp_EntityEdit
-// Purpose  : constructor
+/*! Purpose  : constructor*/
 //================================================================
-SalomeApp_EntityEdit::SalomeApp_EntityEdit(QWidget* parent, 
+SalomeApp_EntityEdit::SalomeApp_EntityEdit(QWidget* parent,
                               int      controlType,
                               int      valueType,
-                              bool     butApply, 
+                              bool     butApply,
                               bool     butCancel) :
 QWidget(parent),
 myEdit(0),
 myCombo(0),
 myApplyBtn(0),
-myCancelBtn(0) 
+myCancelBtn(0)
 {
   SalomeApp_Application* app = dynamic_cast<SalomeApp_Application*>( SUIT_Session::session()->activeApplication() );
   SUIT_ResourceMgr* mgr = app ? app->resourceMgr() : NULL;
@@ -1140,8 +1154,8 @@ myCancelBtn(0)
   aTopLayout->setAlignment( Qt::AlignTop );
   aTopLayout->setSpacing( 0 );
   aTopLayout->setMargin( 1 );
-  if (controlType != etLineEdit && 
-      controlType != etComboBox && 
+  if (controlType != etLineEdit &&
+      controlType != etComboBox &&
       controlType != etComboEdit)
     controlType = etLineEdit;
   if (controlType == etComboBox || controlType == etComboEdit) {
@@ -1170,8 +1184,8 @@ myCancelBtn(0)
     connect(myEdit, SIGNAL(returnPressed()), this, SLOT(onApply()));
     connect(myEdit, SIGNAL(escapePressed()), this, SLOT(onCancel()));
   }
-  if (valueType != vtString && 
-      valueType != vtInteger && 
+  if (valueType != vtString &&
+      valueType != vtInteger &&
       valueType != vtDouble)
     valueType = vtString;
   if (valueType == vtInteger)
@@ -1181,10 +1195,10 @@ myCancelBtn(0)
   if (butApply) {
     // Apply button (V)
     myApplyBtn = new QToolButton(this);
-    
+
     QPixmap anIcon;
     if( mgr )
-      anIcon = mgr->loadPixmap( "STD", tr( "ICON_APPLY" ) );
+      anIcon = mgr->loadPixmap( "STD", tr( "ICON_APPLY" ), false );
 
     myApplyBtn->setPixmap(anIcon);
     myApplyBtn->setEnabled(false);
@@ -1199,7 +1213,7 @@ myCancelBtn(0)
     myCancelBtn = new QToolButton(this);
     QPixmap anIcon;
     if( mgr )
-      anIcon = mgr->loadPixmap( "STD", tr( "ICON_CANCEL" ) );
+      anIcon = mgr->loadPixmap( "STD", tr( "ICON_CANCEL" ), false );
     myCancelBtn->setPixmap(anIcon);
     myCancelBtn->setEnabled(false);
     myCancelBtn->setSizePolicy(QSizePolicy(QSizePolicy::Fixed, QSizePolicy::Fixed));
@@ -1212,17 +1226,17 @@ myCancelBtn(0)
 
 //================================================================
 // Function : SalomeApp_EntityEdit::~SalomeApp_EntityEdit
-// Purpose  : destructor
+/*! Purpose  : destructor*/
 //================================================================
-SalomeApp_EntityEdit::~SalomeApp_EntityEdit() 
+SalomeApp_EntityEdit::~SalomeApp_EntityEdit()
 {
 }
 
 //================================================================
 // Function : SalomeApp_EntityEdit::clear
-// Purpose  : clears edit/combo box
+/*! Purpose  : clears edit/combo box*/
 //================================================================
-void SalomeApp_EntityEdit::clear() 
+void SalomeApp_EntityEdit::clear()
 {
   if (myEdit)
     myEdit->clear();
@@ -1232,9 +1246,9 @@ void SalomeApp_EntityEdit::clear()
 
 //================================================================
 // Function : SalomeApp_EntityEdit::getText
-// Purpose  : returns current text in edit box or combo box
+/*! Purpose  : returns current text in edit box or combo box*/
 //================================================================
-QString SalomeApp_EntityEdit::getText() 
+QString SalomeApp_EntityEdit::getText()
 {
   if (myEdit)
     return myEdit->text();
@@ -1246,9 +1260,9 @@ QString SalomeApp_EntityEdit::getText()
 
 //================================================================
 // Function : SalomeApp_EntityEdit::setText
-// Purpose  : sets text
+/*! Purpose  : sets text*/
 //================================================================
-void SalomeApp_EntityEdit::setText(const QString& theText) 
+void SalomeApp_EntityEdit::setText(const QString& theText)
 {
   myString = theText;
   if (myEdit)
@@ -1264,12 +1278,13 @@ void SalomeApp_EntityEdit::setText(const QString& theText)
 
 //================================================================
 // Function : SalomeApp_EntityEdit::insertItem
-// Purpose  : adds item in combo box, 
-//            sets it current if theSetCurrent is true
+/*! Purpose  : adds item in combo box,
+ *            sets it current if theSetCurrent is true
+ */
 //================================================================
-void SalomeApp_EntityEdit::insertItem(const QString& theValue, 
+void SalomeApp_EntityEdit::insertItem(const QString& theValue,
                                bool           theSetCurrent,
-                               int            theOrder) 
+                               int            theOrder)
 {
   if (myCombo) {
     int aIndexAt = -1;
@@ -1277,8 +1292,8 @@ void SalomeApp_EntityEdit::insertItem(const QString& theValue,
       aIndexAt = 0;
     else if (theOrder == atBeforeCurrent && myCombo->count() > 0)
       aIndexAt = myCombo->currentItem();
-    else if (theOrder == atAfterCurrent && 
-             myCombo->count() > 0 && 
+    else if (theOrder == atAfterCurrent &&
+             myCombo->count() > 0 &&
              myCombo->currentItem() < myCombo->count()-1)
       aIndexAt = myCombo->currentItem() + 1;
     myCombo->insertItem(theValue, aIndexAt);
@@ -1289,11 +1304,12 @@ void SalomeApp_EntityEdit::insertItem(const QString& theValue,
 
 //================================================================
 // Function : SalomeApp_EntityEdit::insertList
-// Purpose  : adds items in combo box, 
-//            sets item theCurrent as current
+/*! Purpose  : adds items in combo box,
+ *            sets item theCurrent as current
+ */
 //================================================================
-void SalomeApp_EntityEdit::insertList(const QStringList& theList, 
-                               const int          theCurrent) 
+void SalomeApp_EntityEdit::insertList(const QStringList& theList,
+                               const int          theCurrent)
 {
   if (myCombo)
     myCombo->insertList(theList);
@@ -1303,11 +1319,12 @@ void SalomeApp_EntityEdit::insertList(const QStringList& theList,
 
 //================================================================
 // Function : SalomeApp_EntityEdit::insertItem
-// Purpose  : adds item in combo box, 
-//            sets it current if theSetCurrent is true
+/*! Purpose  : adds item in combo box,
+ *            sets it current if theSetCurrent is true
+ */
 //================================================================
-void SalomeApp_EntityEdit::insertItem(const int theValue, 
-                               bool      theSetCurrent) 
+void SalomeApp_EntityEdit::insertItem(const int theValue,
+                               bool      theSetCurrent)
 {
   if (myCombo) {
     myCombo->insertItem(theValue);
@@ -1318,11 +1335,12 @@ void SalomeApp_EntityEdit::insertItem(const int theValue,
 
 //================================================================
 // Function : SalomeApp_EntityEdit::insertList
-// Purpose  : adds items in combo box, 
-//            sets item theCurrent as current
+/*! Purpose  : adds items in combo box,
+ *            sets item theCurrent as current
+ */
 //================================================================
-void SalomeApp_EntityEdit::insertList(const TColStd_ListOfInteger& theList, 
-                               const int                    theCurrent) 
+void SalomeApp_EntityEdit::insertList(const TColStd_ListOfInteger& theList,
+                               const int                    theCurrent)
 {
   if (myCombo)
     myCombo->insertList(theList);
@@ -1338,11 +1356,11 @@ void SalomeApp_EntityEdit::insertList(const TColStd_ListOfInteger& theList,
 
 //================================================================
 // Function : SalomeApp_EntityEdit::insertItem
-// Purpose  : adds item in combo box, 
+// Purpose  : adds item in combo box,
 //            sets it current if theSetCurrent is true
 //================================================================
-void SalomeApp_EntityEdit::insertItem(const double theValue, 
-                               bool         theSetCurrent) 
+void SalomeApp_EntityEdit::insertItem(const double theValue,
+                               bool         theSetCurrent)
 {
   if (myCombo) {
     myCombo->insertItem(theValue);
@@ -1353,15 +1371,16 @@ void SalomeApp_EntityEdit::insertItem(const double theValue,
 
 //================================================================
 // Function : SalomeApp_EntityEdit::insertList
-// Purpose  : adds items in combo box, 
-//            sets item theCurrent as current
+/*! Purpose  : adds items in combo box,
+ *            sets item theCurrent as current
+ */
 //================================================================
-void SalomeApp_EntityEdit::insertList(const TColStd_ListOfReal& theList, 
-                               const int                 theCurrent) 
+void SalomeApp_EntityEdit::insertList(const TColStd_ListOfReal& theList,
+                               const int                 theCurrent)
 {
   if (myCombo)
     myCombo->insertList(theList);
-  
+
   TColStd_ListIteratorOfListOfReal aIter(theList);
   for (unsigned i = 0; aIter.More(); aIter.Next(), i++) {
     if (theCurrent == i) {
@@ -1373,9 +1392,9 @@ void SalomeApp_EntityEdit::insertList(const TColStd_ListOfReal& theList,
 
 //================================================================
 // Function : SalomeApp_EntityEdit::getControl
-// Purpose  : gets actual widget
+/*! Purpose  : gets actual widget*/
 //================================================================
-QWidget* SalomeApp_EntityEdit::getControl() 
+QWidget* SalomeApp_EntityEdit::getControl()
 {
   if (myEdit)
     return myEdit;
@@ -1387,9 +1406,9 @@ QWidget* SalomeApp_EntityEdit::getControl()
 
 //================================================================
 // Function : SalomeApp_EntityEdit::setFocus
-// Purpose  : redirect focus to corresponding widget
+/*! Purpose  : redirect focus to corresponding widget*/
 //================================================================
-void SalomeApp_EntityEdit::setFocus() 
+void SalomeApp_EntityEdit::setFocus()
 {
   if (myEdit) {
     myEdit->setFocus();
@@ -1403,9 +1422,9 @@ void SalomeApp_EntityEdit::setFocus()
 
 //================================================================
 // Function : SalomeApp_EntityEdit::setValidator
-// Purpose  : sets validator for the control
+/*! Purpose  : sets validator for the control*/
 //================================================================
-void SalomeApp_EntityEdit::setValidator(const QValidator* theValidator) 
+void SalomeApp_EntityEdit::setValidator(const QValidator* theValidator)
 {
   if (myEdit)
     myEdit->setValidator(theValidator);
@@ -1415,9 +1434,9 @@ void SalomeApp_EntityEdit::setValidator(const QValidator* theValidator)
 
 //================================================================
 // Function : SalomeApp_EntityEdit::keyPressEvent
-// Purpose  : event filter for KeyPress event
+/*! Purpose  : event filter for KeyPress event*/
 //================================================================
-void SalomeApp_EntityEdit::keyPressEvent( QKeyEvent * e) 
+void SalomeApp_EntityEdit::keyPressEvent( QKeyEvent * e)
 {
   if ( (e->key() == Key_Enter ||
         e->key() == Key_Return ) )
@@ -1428,18 +1447,18 @@ void SalomeApp_EntityEdit::keyPressEvent( QKeyEvent * e)
 
 //================================================================
 // Function : SalomeApp_EntityEdit::onComboActivated
-// Purpose  : called when item activated in combo box
+/*! Purpose  : called when item activated in combo box*/
 //================================================================
-void SalomeApp_EntityEdit::onComboActivated(const QString& theText) 
+void SalomeApp_EntityEdit::onComboActivated(const QString& theText)
 {
   onTextChanged(theText);
 }
 
 //================================================================
 // Function : SalomeApp_EntityEdit::onTextChanged
-// Purpose  : slot, called when text changed in line edit
+/*! Purpose  : slot, called when text changed in line edit*/
 //================================================================
-void SalomeApp_EntityEdit::onTextChanged(const QString& theText) 
+void SalomeApp_EntityEdit::onTextChanged(const QString& theText)
 {
   if (myApplyBtn)
     myApplyBtn->setEnabled(!(theText == myString));
@@ -1449,9 +1468,9 @@ void SalomeApp_EntityEdit::onTextChanged(const QString& theText)
 
 //================================================================
 // Function : SalomeApp_EntityEdit::onCancel
-// Purpose  : slot, called when user presses Cancel button
+/*! Purpose  : slot, called when user presses Cancel button*/
 //================================================================
-void SalomeApp_EntityEdit::onCancel() 
+void SalomeApp_EntityEdit::onCancel()
 {
   setText(myString);
   if (myApplyBtn)
@@ -1463,9 +1482,9 @@ void SalomeApp_EntityEdit::onCancel()
 
 //================================================================
 // Function : SalomeApp_EntityEdit::onApply
-// Purpose  : slot, called when user presses Apply button
+/*! Purpose  : slot, called when user presses Apply button*/
 //================================================================
-void SalomeApp_EntityEdit::onApply() 
+void SalomeApp_EntityEdit::onApply()
 {
   myString = getText();
   if (myApplyBtn)
@@ -1477,9 +1496,9 @@ void SalomeApp_EntityEdit::onApply()
 
 //================================================================
 // Function : SalomeApp_EntityEdit::showButtons
-// Purpose  : shows/hides buttons
+/*! Purpose  : shows/hides buttons*/
 //================================================================
-void SalomeApp_EntityEdit::showButtons(bool show) 
+void SalomeApp_EntityEdit::showButtons(bool show)
 {
   if (myApplyBtn)
     show ? myApplyBtn->show()  : myApplyBtn->hide();
@@ -1489,7 +1508,7 @@ void SalomeApp_EntityEdit::showButtons(bool show)
 
 //================================================================
 // Function : SalomeApp_EntityEdit::setDuplicatesEnabled
-// Purpose  : enables/disables data duplication (for combo box)
+/*! Purpose  : enables/disables data duplication (for combo box)*/
 //================================================================
 void SalomeApp_EntityEdit::setDuplicatesEnabled(bool enabled)
 {