src/SALOME_PYQT/SalomePyQt/SalomePyQt.cxx

   1 // Copyright (C) 2007-2016  CEA/DEN, EDF R&D, OPEN CASCADE
   2 //
   3 // Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
   4 // CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
   5 //
   6 // This library is free software; you can redistribute it and/or
   7 // modify it under the terms of the GNU Lesser General Public
   8 // License as published by the Free Software Foundation; either
   9 // version 2.1 of the License, or (at your option) any later version.
  10 //
  11 // This library is distributed in the hope that it will be useful,
  12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14 // Lesser General Public License for more details.
  15 //
  16 // You should have received a copy of the GNU Lesser General Public
  17 // License along with this library; if not, write to the Free Software
  18 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  19 //
  20 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
  21 //
  22
  23 // File   : SalomePyQt.cxx
  24 // Author : Vadim SANDLER, Open CASCADE S.A.S. (vadim.sandler@opencascade.com)
  25
  26 #ifdef WIN32
  27 // E.A. : On windows with python 2.6, there is a conflict
  28 // E.A. : between pymath.h and Standard_math.h which define
  29 // E.A. : some same symbols : acosh, asinh, ...
  30 #include <Standard_math.hxx>
  31 #include <pymath.h>
  32 #endif
  33
  34 #include "SALOME_PYQT_ModuleLight.h" // this include must be first!!!
  35 #include "SALOME_PYQT_DataModelLight.h"
  36 #include "SALOME_PYQT_PyModule.h"
  37 #include "SalomePyQt.h"
  38
  39 #include "LightApp_SelectionMgr.h"
  40 #include "LogWindow.h"
  41 #ifndef DISABLE_OCCVIEWER
  42 #include "OCCViewer_ViewWindow.h"
  43 #include "OCCViewer_ViewFrame.h"
  44 #endif // DISABLE_OCCVIEWER
  45 #ifndef DISABLE_PLOT2DVIEWER
  46 #include "Plot2d_ViewManager.h"
  47 #include "Plot2d_ViewWindow.h"
  48 #endif // DISABLE_PLOT2DVIEWER
  49 #ifndef DISABLE_PVVIEWER
  50 #include "PVViewer_ViewManager.h"
  51 #include "PVViewer_ViewModel.h"
  52 #endif // DISABLE_PVVIEWER
  53 #include "QtxActionMenuMgr.h"
  54 #include "QtxWorkstack.h"
  55 #include "QtxTreeView.h"
  56 #include "SALOME_Event.h"
  57 #include "STD_TabDesktop.h"
  58 #include "SUIT_DataBrowser.h"
  59 #include "SUIT_ResourceMgr.h"
  60 #include "SUIT_Session.h"
  61 #include "SUIT_Tools.h"
  62 #include "SUIT_ViewManager.h"
  63 #include "SUIT_ViewWindow.h"
  64 #include "PyConsole_Console.h"
  65
  66 #include <QAction>
  67 #include <QApplication>
  68 #include <QPaintEvent>
  69 #include <QCoreApplication>
  70
  71 #include <utilities.h>
  72 namespace
  73 {
  74   /*!
  75     \brief Get the currently active application.
  76     \internal
  77     \return active application object or 0 if there is no any
  78   */
  79   LightApp_Application* getApplication()
  80   {
  81     if ( SUIT_Session::session() )
  82       return dynamic_cast<LightApp_Application*>( SUIT_Session::session()->activeApplication() );
  83     return 0;
  84   }
  85
  86   /*!
  87     \brief Get the currently active study.
  88     \internal
  89     \return active study or 0 if there is no study opened
  90   */
  91   LightApp_Study* getActiveStudy()
  92   {
  93     if ( getApplication() )
  94       return dynamic_cast<LightApp_Study*>( getApplication()->activeStudy() );
  95     return 0;
  96   }
  97
  98   /*!
  99     \brief Get the currently active module.
 100     \internal
 101     This function returns correct result only if Python-based
 102     module is currently active. Otherwize, 0 is returned.
 103   */
 104   LightApp_Module* getActiveModule()
 105   {
 106     LightApp_Module* module = 0;
 107     if ( LightApp_Application* anApp = getApplication() ) {
 108       module = PyModuleHelper::getInitModule();
 109       if ( !module )
 110         module = dynamic_cast<LightApp_Module*>( anApp->activeModule() );
 111     }
 112     return module;
 113   }
 114
 115   /*!
 116     \brief Get the currently active Python module's helper.
 117     \internal
 118     This function returns correct result only if Python-based
 119     module is currently active. Otherwize, 0 is returned.
 120   */
 121   PyModuleHelper* getPythonHelper()
 122   {
 123     LightApp_Module* module = getActiveModule();
 124     PyModuleHelper* helper = module ? module->findChild<PyModuleHelper*>( "python_module_helper" ) : 0;
 125     return helper;
 126   }
 127
 128   /*!
 129     \brief Get SALOME verbose level
 130     \internal
 131     \return \c true if SALOME debug output is allowed or \c false otherwise
 132   */
 133   bool verbose()
 134   {
 135     bool isVerbose = false;
 136     if ( getenv( "SALOME_VERBOSE" ) ) {
 137       QString envVar = getenv( "SALOME_VERBOSE" );
 138       bool ok;
 139       int value = envVar.toInt( &ok );
 140       isVerbose = ok && value != 0;
 141     }
 142     return isVerbose;
 143   }
 144
 145   /*!
 146     \brief Get menu item title
 147     \internal
 148     \param menuId menu identifier
 149     \return menu title (localized)
 150   */
 151   QString getMenuName( const QString& menuId )
 152   {
 153     QStringList contexts;
 154     contexts << "SalomeApp_Application" << "LightApp_Application" << "STD_TabDesktop" <<
 155       "STD_MDIDesktop" << "STD_Application" << "SUIT_Application" << "";
 156     QString menuName = menuId;
 157     for ( int i = 0; i < contexts.count() && menuName == menuId; i++ )
 158       menuName = QApplication::translate( contexts[i].toLatin1().data(), menuId.toLatin1().data() );
 159     return menuName;
 160   }
 161
 162   /*!
 163     \brief Load module icon
 164     \internal
 165     \param module module name
 166     \param fileName path to the icon file
 167     \return icon
 168   */
 169   QIcon loadIconInternal( const QString& module, const QString& fileName )
 170   {
 171     QIcon icon;
 172
 173     LightApp_Application* app = getApplication();
 174
 175     if ( app && !fileName.isEmpty() ) {
 176       QPixmap pixmap = app->resourceMgr()->loadPixmap( module,
 177                                                        QApplication::translate( module.toLatin1().data(),
 178                                                                                 fileName.toLatin1().data() ) );
 179       if ( !pixmap.isNull() )
 180         icon = QIcon( pixmap );
 181     }
 182     return icon;
 183   }
 184
 185   /*!
 186     \brief Gets window with specified identifier
 187     \internal
 188     \param id window identifier
 189     \return pointer on the window
 190   */
 191   SUIT_ViewWindow* getWnd( const int id )
 192   {
 193     SUIT_ViewWindow* resWnd = 0;
 194
 195     LightApp_Application* app = getApplication();
 196     if ( app ) {
 197       ViewManagerList vmlist = app->viewManagers();
 198       foreach( SUIT_ViewManager* vm, vmlist ) {
 199         QVector<SUIT_ViewWindow*> vwlist = vm->getViews();
 200         foreach ( SUIT_ViewWindow* vw, vwlist ) {
 201           if ( id == vw->getId() ) {
 202             resWnd = vw;
 203             break;
 204           }
 205         }
 206       }
 207     }
 208     return resWnd;
 209   }
 210
 211   /*!
 212     \brief Map of created selection objects.
 213     \internal
 214   */
 215   QMap<LightApp_Application*, SALOME_Selection*> SelMap;
 216
 217   /*!
 218     \brief Default resource file section name.
 219     \internal
 220   */
 221   const char* DEFAULT_SECTION = "SalomePyQt";
 222 }
 223
 224 /*!
 225   \class SALOME_Selection
 226   \brief The class represents selection which can be used in Python.
 227 */
 228
 229 /*!
 230   \brief Get the selection object for the specified application.
 231
 232   Finds or creates the selection object (one per study).
 233
 234   \param app application object
 235   \return selection object or 0 if \a app is invalid
 236 */
 237 SALOME_Selection* SALOME_Selection::GetSelection( LightApp_Application* app )
 238 {
 239   SALOME_Selection* sel = 0;
 240   if ( app && SelMap.find( app ) != SelMap.end() )
 241     sel = SelMap[ app ];
 242   else
 243     sel = SelMap[ app ] = new SALOME_Selection( app );
 244   return sel;
 245 }
 246
 247
 248 /*!
 249   \brief Constructor.
 250   \param p parent object
 251 */
 252 SALOME_Selection::SALOME_Selection( QObject* p ) : QObject( 0 ), mySelMgr( 0 )
 253 {
 254   LightApp_Application* app = dynamic_cast<LightApp_Application*>( p );
 255   if ( app ) {
 256     mySelMgr = app->selectionMgr();
 257     connect( mySelMgr, SIGNAL( selectionChanged() ), this, SIGNAL( currentSelectionChanged() ) );
 258     connect( mySelMgr, SIGNAL( destroyed() ),        this, SLOT  ( onSelMgrDestroyed() ) );
 259   }
 260 }
 261
 262 /*!
 263   \brief Destructor.
 264 */
 265 SALOME_Selection::~SALOME_Selection()
 266 {
 267   LightApp_Application* app = 0;
 268   QMap<LightApp_Application*, SALOME_Selection*>::Iterator it;
 269   for ( it = SelMap.begin(); it != SelMap.end() && !app; ++it ) {
 270     if ( it.value() == this ) app = it.key();
 271   }
 272   if ( app ) SelMap.remove( app );
 273 }
 274
 275 /*!
 276   \brief Called when selection manager is destroyed (usually
 277   when the study is closed).
 278 */
 279 void SALOME_Selection::onSelMgrDestroyed()
 280 {
 281   mySelMgr = 0;
 282 }
 283
 284 /*!
 285   \brief Clear the selection.
 286 */
 287 void SALOME_Selection::Clear()
 288 {
 289   class TEvent: public SALOME_Event
 290   {
 291     LightApp_SelectionMgr* mySelMgr;
 292   public:
 293     TEvent( LightApp_SelectionMgr* selMgr )
 294       : mySelMgr( selMgr ) {}
 295     virtual void Execute()
 296     {
 297       if ( mySelMgr )
 298         mySelMgr->clearSelected();
 299     }
 300   };
 301   ProcessVoidEvent( new TEvent( mySelMgr ) );
 302 }
 303
 304 /*!
 305   \brief Clear the selection.
 306 */
 307 void SALOME_Selection::ClearIObjects()
 308 {
 309   Clear();
 310 }
 311
 312 /*!
 313   Removes all selection filters.
 314 */
 315 void SALOME_Selection::ClearFilters()
 316 {
 317   class TEvent: public SALOME_Event
 318   {
 319     LightApp_SelectionMgr* mySelMgr;
 320   public:
 321     TEvent( LightApp_SelectionMgr* selMgr )
 322       : mySelMgr( selMgr ) {}
 323     virtual void Execute()
 324     {
 325       if ( mySelMgr )
 326         mySelMgr->clearFilters();
 327     }
 328   };
 329   ProcessVoidEvent( new TEvent( mySelMgr ) );
 330 }
 331
 332 /*!
 333   \class SalomePyQt
 334   \brief The class provides utility functions which can be used in the Python
 335   to operate with the SALOME GUI.
 336
 337   All the functionality of this class is implemented as static methods, so they
 338   can be called with the class name prefixed or via creation of the class instance.
 339   For example, next both ways of SalomePyQt class usage are legal:
 340   \code
 341   from SalomePyQt import *
 342   sg = SalomePyQt()
 343   # using SalomePyQt class instance
 344   desktop = sg.getDesktop()
 345   # using SalomePyQt class directly
 346   menubar = SalomePyQt.getMainMenuBar()
 347   \endcode
 348 */
 349
 350 /*!
 351   \fn QWidget* SalomePyQt::getDesktop();
 352   \brief Get the active application's desktop window.
 353   \return desktop window or 0 if there is no any
 354 */
 355
 356 class TGetDesktopEvent: public SALOME_Event
 357 {
 358 public:
 359   typedef QWidget* TResult;
 360   TResult myResult;
 361   TGetDesktopEvent() : myResult( 0 ) {}
 362   virtual void Execute()
 363   {
 364     if ( getApplication() )
 365       myResult = (QWidget*)( getApplication()->desktop() );
 366   }
 367 };
 368 QWidget* SalomePyQt::getDesktop()
 369 {
 370   return ProcessEvent( new TGetDesktopEvent() );
 371 }
 372
 373 /*!
 374   \fn QWidget* SalomePyQt::getMainFrame();
 375   \brief Get current application's main frame widget [obsolete].
 376
 377   Main frame widget is an internal widget of the application
 378   desktop window (workspace).
 379
 380   \return workspace widget (0 on any error)
 381 */
 382
 383 class TGetMainFrameEvent: public SALOME_Event
 384 {
 385 public:
 386   typedef QWidget* TResult;
 387   TResult myResult;
 388   TGetMainFrameEvent() : myResult( 0 ) {}
 389   virtual void Execute()
 390   {
 391     if ( getApplication() ) {
 392       SUIT_Desktop* aDesktop = getApplication()->desktop();
 393       myResult = (QWidget*)( aDesktop->centralWidget() );
 394     }
 395   }
 396 };
 397 QWidget* SalomePyQt::getMainFrame()
 398 {
 399   return ProcessEvent( new TGetMainFrameEvent() );
 400 }
 401
 402 /*!
 403   \fn QMenuBar* SalomePyQt::getMainMenuBar();
 404   \brief Get current application desktop's main menu.
 405   \return main menu object (0 on any error)
 406 */
 407
 408 class TGetMainMenuBarEvent: public SALOME_Event
 409 {
 410 public:
 411   typedef QMenuBar* TResult;
 412   TResult myResult;
 413   TGetMainMenuBarEvent() : myResult( 0 ) {}
 414   virtual void Execute()
 415   {
 416     if ( LightApp_Application* anApp = getApplication() ) {
 417       myResult = anApp->desktop()->menuBar();
 418     }
 419   }
 420 };
 421 QMenuBar* SalomePyQt::getMainMenuBar()
 422 {
 423   return ProcessEvent( new TGetMainMenuBarEvent() );
 424 }
 425
 426 /*!
 427   \fn QMenu* SalomePyQt::getPopupMenu( const MenuName menu );
 428   \brief Get main menu's child popup submenu by its identifier.
 429
 430   This function is obsolete.
 431   Use QMenu* SalomePyQt::getPopupMenu( const QString& menu ) instead.
 432
 433   \param menu menu identifier
 434   \return popup submenu object or 0 if it does not exist
 435 */
 436
 437 /*!
 438   \fn QMenu* SalomePyQt::getPopupMenu( const QString& menu );
 439   \brief Get main menu's child popup submenu by its name.
 440
 441   The function creates menu if it does not exist.
 442
 443   \param menu menu name
 444   \return popup submenu object (0 on any error)
 445 */
 446
 447 class TGetPopupMenuEvent: public SALOME_Event
 448 {
 449 public:
 450   typedef QMenu* TResult;
 451   TResult myResult;
 452   QString myMenuName;
 453   TGetPopupMenuEvent( const QString& menu ) : myResult( 0 ), myMenuName( menu ) {}
 454   virtual void Execute()
 455   {
 456     LightApp_Application* anApp = getApplication();
 457     if ( anApp && !myMenuName.isEmpty() ) {
 458       QtxActionMenuMgr* mgr = anApp->desktop()->menuMgr();
 459       myResult = mgr->findMenu( myMenuName, -1, false ); // search only top menu
 460     }
 461   }
 462 };
 463
 464 QMenu* SalomePyQt::getPopupMenu( const MenuName menu )
 465 {
 466   QString menuName;
 467   switch( menu ) {
 468   case File:
 469     menuName = getMenuName( "MEN_DESK_FILE" );        break;
 470   case View:
 471     menuName = getMenuName( "MEN_DESK_VIEW" );        break;
 472   case Edit:
 473     menuName = getMenuName( "MEN_DESK_EDIT" );        break;
 474   case Preferences:
 475     menuName = getMenuName( "MEN_DESK_PREFERENCES" ); break;
 476   case Tools:
 477     menuName = getMenuName( "MEN_DESK_TOOLS" );       break;
 478   case Window:
 479     menuName = getMenuName( "MEN_DESK_WINDOW" );      break;
 480   case Help:
 481     menuName = getMenuName( "MEN_DESK_HELP" );        break;
 482   }
 483   return ProcessEvent( new TGetPopupMenuEvent( menuName ) );
 484 }
 485 QMenu* SalomePyQt::getPopupMenu( const QString& menu )
 486 {
 487   return ProcessEvent( new TGetPopupMenuEvent( menu ) );
 488 }
 489
 490 /*!
 491   \fn QTreeView* SalomePyQt::getObjectBrowser();
 492   \brief Get object browser
 493   \return object browser for the active study or 0 in case of error
 494 */
 495
 496 class TGetObjectBrowserEvent: public SALOME_Event
 497 {
 498 public:
 499   typedef QTreeView* TResult;
 500   TResult myResult;
 501   TGetObjectBrowserEvent() : myResult( 0 ) {}
 502   virtual void Execute()
 503   {
 504     LightApp_Application* anApp = getApplication();
 505     if ( anApp && anApp->objectBrowser() ) {
 506       myResult = anApp->objectBrowser()->treeView();
 507     }
 508   }
 509 };
 510 QTreeView* SalomePyQt::getObjectBrowser()
 511 {
 512   return ProcessEvent( new TGetObjectBrowserEvent() );
 513 }
 514
 515 /*!
 516   \fn int SalomePyQt::getStudyId();
 517   \brief Get active study's identifier.
 518   \return active study ID or 0 if there is no active study
 519 */
 520
 521 class TGetStudyIdEvent: public SALOME_Event
 522 {
 523 public:
 524   typedef int TResult;
 525   TResult myResult;
 526   TGetStudyIdEvent() : myResult( 0 ) {}
 527   virtual void Execute()
 528   {
 529     if ( LightApp_Study* aStudy = getActiveStudy() ) {
 530       myResult = aStudy->id();
 531     }
 532   }
 533 };
 534 int SalomePyQt::getStudyId()
 535 {
 536   return ProcessEvent( new TGetStudyIdEvent() );
 537 }
 538
 539 /*!
 540   \fn SALOME_Selection* SalomePyQt::getSelection();
 541   \brief Get the selection object for the current study.
 542
 543   Creates a Selection object if it has not been created yet.
 544
 545   \return selection object (0 on error)
 546 */
 547
 548 class TGetSelectionEvent: public SALOME_Event
 549 {
 550 public:
 551   typedef SALOME_Selection* TResult;
 552   TResult myResult;
 553   TGetSelectionEvent() : myResult( 0 ) {}
 554   virtual void Execute()
 555   {
 556     myResult = SALOME_Selection::GetSelection( getApplication() );
 557   }
 558 };
 559 SALOME_Selection* SalomePyQt::getSelection()
 560 {
 561   return ProcessEvent( new TGetSelectionEvent() );
 562 }
 563
 564 /*!
 565   \fn QStringList* SalomePyQt::setSelection(const QStringList& );
 566   \brief Send local selection for notification.
 567
 568   The list of locally selected objects (study entries) is sent for notification of
 569   other listening entities (modules, viewers...).
 570 */
 571
 572 class TSetSelectionEvent: public SALOME_Event
 573 {
 574   QStringList myEntryList;
 575 public:
 576   TSetSelectionEvent(const QStringList& entryList) : myEntryList(entryList) {}
 577   virtual void Execute()
 578   {
 579         SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
 580         if ( !module ) return;
 581         module->setLocalSelected(myEntryList);
 582   }
 583 };
 584 void SalomePyQt::setSelection( const QStringList& entryList)
 585 {
 586   return ProcessVoidEvent( new TSetSelectionEvent(entryList) );
 587 }
 588
 589 /*!
 590   \fn void SalomePyQt::putInfo( const QString& msg, const int sec );
 591   \brief Put an information message to the current application's
 592   desktop status bar.
 593
 594   Optional second delay parameter (\a sec) can be used to specify
 595   time of the message diplaying in seconds. If this parameter is less
 596   or equal to zero, the constant message will be put.
 597
 598   \param msg message text
 599   \param sec message displaying time in seconds
 600 */
 601
 602 class TPutInfoEvent: public SALOME_Event
 603 {
 604   QString myMsg;
 605   int     mySecs;
 606 public:
 607   TPutInfoEvent( const QString& msg, const int sec = 0 ) : myMsg( msg ), mySecs( sec ) {}
 608   virtual void Execute()
 609   {
 610     if ( LightApp_Application* anApp = getApplication() ) {
 611       anApp->putInfo( myMsg, mySecs * 1000 );
 612     }
 613   }
 614 };
 615 void SalomePyQt::putInfo( const QString& msg, const int sec )
 616 {
 617   ProcessVoidEvent( new TPutInfoEvent( msg, sec ) );
 618 }
 619
 620 /*!
 621   \fn const QString SalomePyQt::getActiveComponent();
 622   \brief Get the currently active module name (for the current study).
 623   \return active module name or empty string if there is no active module
 624 */
 625
 626 class TGetActiveComponentEvent: public SALOME_Event
 627 {
 628 public:
 629   typedef QString TResult;
 630   TResult myResult;
 631   TGetActiveComponentEvent() {}
 632   virtual void Execute()
 633   {
 634     if ( LightApp_Application* anApp = getApplication() ) {
 635       if ( CAM_Module* mod = anApp->activeModule() ) {
 636         myResult = mod->name();
 637       }
 638     }
 639   }
 640 };
 641 const QString SalomePyQt::getActiveComponent()
 642 {
 643   return ProcessEvent( new TGetActiveComponentEvent() );
 644 }
 645
 646 /*!
 647   \fn PyObject* SalomePyQt::getActivePythonModule();
 648   \brief Access to Python module object currently loaded into SALOME_PYQT_ModuleLight container.
 649   \return Python module object currently loaded into SALOME_PYQT_ModuleLight container
 650 */
 651
 652 class TGetActivePyModuleEvent: public SALOME_Event
 653 {
 654 public:
 655   typedef PyObject* TResult;
 656   TResult myResult;
 657   TGetActivePyModuleEvent() : myResult( Py_None ) {}
 658   virtual void Execute()
 659   {
 660     PyModuleHelper* helper = getPythonHelper();
 661     if ( helper )
 662       myResult = (PyObject*)helper->pythonModule();
 663   }
 664 };
 665 PyObject* SalomePyQt::getActivePythonModule()
 666 {
 667   return ProcessEvent( new TGetActivePyModuleEvent() );
 668 }
 669
 670 /*!
 671   \fn bool SalomePyQt::activateModule( const QString& modName );
 672   \brief Activates SALOME module with the given name
 673   \return True if the module has been activated and False otherwise.
 674 */
 675
 676 class TActivateModuleEvent: public SALOME_Event
 677 {
 678 public:
 679   typedef bool TResult;
 680   TResult myResult;
 681   QString myModuleName;
 682   TActivateModuleEvent( const QString& modName )
 683   : myResult( false ), myModuleName( modName ) {}
 684   virtual void Execute()
 685   {
 686     if ( LightApp_Application* anApp = getApplication() ) {
 687       myResult = anApp->activateModule( myModuleName );
 688     }
 689   }
 690 };
 691 bool SalomePyQt::activateModule( const QString& modName )
 692 {
 693   return ProcessEvent( new TActivateModuleEvent( modName ) );
 694 }
 695
 696 /*!
 697   \brief Update an Object Browser of the specified (by identifier) study.
 698
 699   If \a studyId <= 0 the active study's object browser is updated.
 700   The \a updateSelection parameter is obsolete and currently is not used.
 701   This parameter will be removed in future, so try to avoid its usage in
 702   your code.
 703
 704   \brief studyId study identifier
 705   \brief updateSelection update selection flag (not used)
 706   \sa getActiveStudy()
 707 */
 708 void SalomePyQt::updateObjBrowser( const int studyId, bool updateSelection )
 709 {
 710   class TEvent: public SALOME_Event
 711   {
 712     int  myStudyId;
 713     bool myUpdateSelection;
 714   public:
 715     TEvent( const int studyId, bool updateSelection )
 716       : myStudyId( studyId ), myUpdateSelection( updateSelection ) {}
 717     virtual void Execute()
 718     {
 719       if ( SUIT_Session::session() ) {
 720         if ( getActiveStudy() && myStudyId <= 0 )
 721           myStudyId = getActiveStudy()->id();
 722         if ( myStudyId > 0 ) {
 723           QList<SUIT_Application*> apps = SUIT_Session::session()->applications();
 724           QList<SUIT_Application*>::Iterator it;
 725           for( it = apps.begin(); it != apps.end(); ++it ) {
 726             LightApp_Application* anApp = dynamic_cast<LightApp_Application*>( *it );
 727             if ( anApp && anApp->activeStudy() && anApp->activeStudy()->id() == myStudyId ) {
 728               anApp->updateObjectBrowser();
 729               return;
 730             }
 731           }
 732         }
 733       }
 734     }
 735   };
 736   ProcessVoidEvent( new TEvent( studyId, updateSelection ) );
 737 }
 738
 739
 740 /*!
 741   SalomePyQt::isModified()
 742   \return The modification status of the data model
 743   for the currently active Python module
 744   \note This function is supported for "light" Python-based SALOME modules only.
 745   \sa setModified()
 746 */
 747 class TIsModifiedEvent: public SALOME_Event
 748 {
 749 public:
 750   typedef bool TResult;
 751   TResult myResult;
 752   TIsModifiedEvent() : myResult( false ) {}
 753   virtual void Execute()
 754   {
 755     LightApp_Module* module = getActiveModule();
 756     if ( !module )
 757       return;
 758
 759     SALOME_PYQT_DataModelLight* aModel =
 760       dynamic_cast<SALOME_PYQT_DataModelLight*>( module->dataModel() );
 761     if ( aModel ) {
 762       myResult = aModel->isModified();
 763     }
 764     else {
 765       if ( verbose() ) printf( "SalomePyQt.isModified() function is not supported for the current module.\n" );
 766     }
 767   }
 768 };
 769 bool SalomePyQt::isModified()
 770 {
 771   return ProcessEvent(new TIsModifiedEvent());
 772 }
 773
 774 /*!
 775   SalomePyQt::setModified()
 776
 777   Sets the modification status of the data model for
 778   the currently active Python module. This method should be used
 779   by the Python code in order to enable/disable "Save" operation
 780   depending on the module's data state.
 781
 782   \note This function is supported for "light" Python-based SALOME modules only.
 783
 784   \param New modification status of the data model
 785
 786   \sa isModified()
 787 */
 788 void SalomePyQt::setModified( bool flag )
 789 {
 790   class TEvent: public SALOME_Event
 791   {
 792     bool myFlag;
 793   public:
 794     TEvent( bool flag )
 795       : myFlag( flag ) {}
 796     virtual void Execute()
 797     {
 798       LightApp_Module* module = getActiveModule();
 799       if ( !module )
 800         return;
 801
 802       SALOME_PYQT_DataModelLight* model =
 803         dynamic_cast<SALOME_PYQT_DataModelLight*>( module->dataModel() );
 804
 805       LightApp_Application* app = module->getApp();
 806
 807       if ( model && app ) {
 808         model->setModified( myFlag );
 809         app->updateActions();
 810       }
 811       else {
 812         if ( verbose() ) printf( "SalomePyQt.setModified() function is not supported for the current module.\n" );
 813       }
 814     }
 815   };
 816   ProcessVoidEvent( new TEvent( flag ) );
 817 }
 818
 819 /*!
 820   \brief Add string setting to the application preferences.
 821
 822   The parameter \a autoValue is obsolete parameter and currently is not used.
 823   This parameter will be removed in future, so try to avoid its usage in
 824   your code.
 825
 826   This function is obsolete. Use one of addSetting() instead.
 827
 828   \param name setting name (it should be of kind <section:setting> where
 829   \c section is resources section name and \c setting is setting name)
 830   \param value new setting value
 831   \param autoValue (not used)
 832 */
 833 void SalomePyQt::addStringSetting( const QString& name, const QString& value, bool autoValue )
 834 {
 835   class TEvent: public SALOME_Event
 836   {
 837     QString myName;
 838     QString myValue;
 839     bool    myAutoValue;
 840   public:
 841     TEvent( const QString& name, const QString& value, bool autoValue )
 842       : myName( name ), myValue( value ), myAutoValue( autoValue ) {}
 843     virtual void Execute()
 844     {
 845       if ( SUIT_Session::session() ) {
 846         SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
 847         QStringList sl = myName.split( ":", QString::SkipEmptyParts );
 848         QString _sec = sl.count() > 1 ? sl[ 0 ].trimmed() : QString( DEFAULT_SECTION );
 849         QString _nam = sl.count() > 1 ? sl[ 1 ].trimmed() : sl.count() > 0 ? sl[ 0 ].trimmed() : QString( "" );
 850         if ( !_sec.isEmpty() && !_nam.isEmpty() )
 851           resMgr->setValue( _sec, _nam, myValue );
 852       }
 853     }
 854   };
 855   ProcessVoidEvent( new TEvent( name, value, autoValue ) );
 856 }
 857
 858 /*!
 859   \brief Add integer setting to the application preferences.
 860
 861   The parameter \a autoValue is obsolete parameter and currently is not used.
 862   This parameter will be removed in future, so try to avoid its usage in
 863   your code.
 864
 865   This function is obsolete. Use one of addSetting() instead.
 866
 867   \param name setting name (it should be of kind <section:setting> where
 868   \c section is resources section name and \c setting is setting name)
 869   \param value new setting value
 870   \param autoValue (not used)
 871 */
 872 void SalomePyQt::addIntSetting( const QString& name, const int value, bool autoValue)
 873 {
 874   class TEvent: public SALOME_Event
 875   {
 876     QString myName;
 877     int     myValue;
 878     bool    myAutoValue;
 879   public:
 880     TEvent( const QString& name, const int value, bool autoValue )
 881       : myName( name ), myValue( value ), myAutoValue( autoValue ) {}
 882     virtual void Execute()
 883     {
 884       if ( SUIT_Session::session() ) {
 885         SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
 886         QStringList sl = myName.split( ":", QString::SkipEmptyParts );
 887         QString _sec = sl.count() > 1 ? sl[ 0 ].trimmed() : QString( DEFAULT_SECTION );
 888         QString _nam = sl.count() > 1 ? sl[ 1 ].trimmed() : sl.count() > 0 ? sl[ 0 ].trimmed() : QString( "" );
 889         if ( !_sec.isEmpty() && !_nam.isEmpty() )
 890           resMgr->setValue( _sec, _nam, myValue );
 891       }
 892     }
 893   };
 894   ProcessVoidEvent( new TEvent( name, value, autoValue ) );
 895 }
 896
 897 /*!
 898   \brief Add double setting to the application preferences.
 899
 900   The parameter \a autoValue is obsolete parameter and currently is not used.
 901   This parameter will be removed in future, so try to avoid its usage in
 902   your code.
 903
 904   This function is obsolete. Use one of addSetting() instead.
 905
 906   \param name setting name (it should be of kind <section:setting> where
 907   \c section is resources section name and \c setting is setting name)
 908   \param value new setting value
 909   \param autoValue (not used)
 910 */
 911 void SalomePyQt::addDoubleSetting( const QString& name, const double value, bool autoValue )
 912 {
 913   class TEvent: public SALOME_Event
 914   {
 915     QString myName;
 916     double  myValue;
 917     bool    myAutoValue;
 918   public:
 919     TEvent( const QString& name, const double value, bool autoValue )
 920       : myName( name ), myValue( value ), myAutoValue( autoValue ) {}
 921     virtual void Execute()
 922     {
 923       if ( SUIT_Session::session() ) {
 924         SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
 925         QStringList sl = myName.split( ":", QString::SkipEmptyParts );
 926         QString _sec = sl.count() > 1 ? sl[ 0 ].trimmed() : QString( DEFAULT_SECTION );
 927         QString _nam = sl.count() > 1 ? sl[ 1 ].trimmed() : sl.count() > 0 ? sl[ 0 ].trimmed() : QString( "" );
 928         if ( !_sec.isEmpty() && !_nam.isEmpty() )
 929           resMgr->setValue( _sec, _nam, myValue );
 930       }
 931     }
 932   };
 933   ProcessVoidEvent( new TEvent( name, value, autoValue ) );
 934 }
 935
 936 /*!
 937   \brief Add boolean setting to the application preferences.
 938
 939   The parameter \a autoValue is obsolete parameter and currently is not used.
 940   This parameter will be removed in future, so try to avoid its usage in
 941   your code.
 942
 943   This function is obsolete. Use one of addSetting() instead.
 944
 945   \param name setting name (it should be of kind <section:setting> where
 946   \c section is resources section name and \c setting is setting name)
 947   \param value new setting value
 948   \param autoValue (not used)
 949 */
 950 void SalomePyQt::addBoolSetting( const QString& name, const bool value, bool autoValue )
 951 {
 952   class TEvent: public SALOME_Event
 953   {
 954     QString myName;
 955     bool    myValue;
 956     bool    myAutoValue;
 957   public:
 958     TEvent( const QString& name, const bool value, bool autoValue )
 959       : myName( name ), myValue( value ), myAutoValue( autoValue ) {}
 960     virtual void Execute()
 961     {
 962       if ( SUIT_Session::session() ) {
 963         SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
 964         QStringList sl = myName.split( ":", QString::SkipEmptyParts );
 965         QString _sec = sl.count() > 1 ? sl[ 0 ].trimmed() : QString( DEFAULT_SECTION );
 966         QString _nam = sl.count() > 1 ? sl[ 1 ].trimmed() : sl.count() > 0 ? sl[ 0 ].trimmed() : QString( "" );
 967         if ( !_sec.isEmpty() && !_nam.isEmpty() )
 968           resMgr->setValue( _sec, _nam, myValue );
 969       }
 970     }
 971   };
 972   ProcessVoidEvent( new TEvent( name, value, autoValue ) );
 973 }
 974
 975 /*!
 976   \brief Remove setting from the application preferences.
 977
 978   This function is obsolete. Use removeSetting() instead.
 979
 980   \param name setting name (it should be of kind <section:setting> where
 981   \c section is resources section name and \c setting is setting name)
 982 */
 983 void SalomePyQt::removeSettings( const QString& name )
 984 {
 985   class TEvent: public SALOME_Event
 986   {
 987     QString myName;
 988   public:
 989     TEvent( const QString& name ) : myName( name ) {}
 990     virtual void Execute()
 991     {
 992       if ( SUIT_Session::session() ) {
 993         SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
 994         QStringList sl = myName.split( ":", QString::SkipEmptyParts );
 995         QString _sec = sl.count() > 1 ? sl[ 0 ].trimmed() : QString( DEFAULT_SECTION );
 996         QString _nam = sl.count() > 1 ? sl[ 1 ].trimmed() : sl.count() > 0 ? sl[ 0 ].trimmed() : QString( "" );
 997         if ( !_sec.isEmpty() && !_nam.isEmpty() )
 998           resMgr->remove( _sec, _nam );
 999       }
1000     }
1001   };
1002   ProcessVoidEvent( new TEvent( name ) );
1003 }
1004
1005 /*!
1006   \fn QString SalomePyQt::getSetting( const QString& name );
1007   \brief Get application setting value (as string represenation).
1008
1009   This function is obsolete. Use stringSetting(), integerSetting(),
1010   boolSetting(), stringSetting() or colorSetting() instead.
1011
1012   \param name setting name (it should be of kind <section:setting> where
1013   \c section is resources section name and \c setting is setting name)
1014   \return setting name (empty string if setting name is invalid)
1015 */
1016
1017 class TGetSettingEvent: public SALOME_Event
1018 {
1019 public:
1020   typedef QString TResult;
1021   TResult myResult;
1022   QString myName;
1023   TGetSettingEvent( const QString& name ) : myName( name ) {}
1024   virtual void Execute()
1025   {
1026     if ( SUIT_Session::session() ) {
1027       SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1028       QStringList sl = myName.split( ":", QString::SkipEmptyParts );
1029       QString _sec = sl.count() > 1 ? sl[ 0 ].trimmed() : QString( DEFAULT_SECTION );
1030       QString _nam = sl.count() > 1 ? sl[ 1 ].trimmed() : sl.count() > 0 ? sl[ 0 ].trimmed() : QString( "" );
1031       myResult = ( !_sec.isEmpty() && !_nam.isEmpty() ) ? resMgr->stringValue( _sec, _nam, "" ) : QString( "" );
1032     }
1033   }
1034 };
1035 QString SalomePyQt::getSetting( const QString& name )
1036 {
1037   return ProcessEvent( new TGetSettingEvent( name ) );
1038 }
1039
1040 /*!
1041   \fn QString SalomePyQt::constant( const QString& name );
1042   \brief Get constant's value from application's resource manager.
1043
1044   \param name name of the constant
1045   \return value of the constant
1046
1047   \sa setConstant()
1048 */
1049
1050 class TGetConstantEvent: public SALOME_Event
1051 {
1052 public:
1053   typedef QString TResult;
1054   TResult myResult;
1055   QString myName;
1056   TGetConstantEvent( const QString& name ) : myName( name ) {}
1057   virtual void Execute()
1058   {
1059     if ( SUIT_Session::session() )
1060       myResult = SUIT_Session::session()->resourceMgr()->constant( myName );
1061   }
1062 };
1063 QString SalomePyQt::constant( const QString& name )
1064 {
1065   return ProcessEvent( new TGetConstantEvent( name ) );
1066 }
1067
1068 /*!
1069   \brief Add constant to the application's resource manager.
1070
1071   This function is useful to specify programmatically specific
1072   variables that are referenced in the resource setting.
1073
1074   For example, some resource value can be set as "$(myroot)/data/files".
1075   Then, "mypath" constant can be set programmatically by the application
1076   depending on run-time requirements.
1077
1078   \param section resources file section name
1079   \param name name of the constant
1080   \param value value of the constant
1081
1082   \sa constant()
1083 */
1084 void SalomePyQt::setConstant( const QString& name, const QString& value )
1085 {
1086   class TEvent: public SALOME_Event
1087   {
1088     QString myName, myValue;
1089   public:
1090     TEvent( const QString& name, const QString& value )
1091       : myName( name ), myValue( value ) {}
1092     virtual void Execute()
1093     {
1094       if ( SUIT_Session::session() )
1095         SUIT_Session::session()->resourceMgr()->setConstant( myName, myValue );
1096     }
1097   };
1098   ProcessVoidEvent( new TEvent( name, value ) );
1099 }
1100
1101 /*!
1102   \brief Add double setting to the application preferences.
1103   \param section resources file section name
1104   \param name setting name
1105   \param value new setting value
1106 */
1107 void SalomePyQt::addSetting( const QString& section, const QString& name, const double value )
1108 {
1109   class TEvent: public SALOME_Event
1110   {
1111     QString mySection;
1112     QString myName;
1113     double  myValue;
1114   public:
1115     TEvent( const QString& section, const QString& name, double value )
1116       : mySection( section ), myName( name ), myValue( value ) {}
1117     virtual void Execute()
1118     {
1119       if ( SUIT_Session::session() ) {
1120         SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1121         if ( !mySection.isEmpty() && !myName.isEmpty() )
1122           resMgr->setValue( mySection, myName, myValue );
1123       }
1124     }
1125   };
1126   ProcessVoidEvent( new TEvent( section, name, value ) );
1127 }
1128
1129 /*!
1130   \brief Add integer setting to the application preferences.
1131   \param section resources file section name
1132   \param name setting name
1133   \param value new setting value
1134 */
1135 void SalomePyQt::addSetting( const QString& section, const QString& name, const int value )
1136 {
1137   class TEvent: public SALOME_Event
1138   {
1139     QString mySection;
1140     QString myName;
1141     int     myValue;
1142   public:
1143     TEvent( const QString& section, const QString& name, int value )
1144       : mySection( section ), myName( name ), myValue( value ) {}
1145     virtual void Execute()
1146     {
1147       if ( SUIT_Session::session() ) {
1148         SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1149         if ( !mySection.isEmpty() && !myName.isEmpty() )
1150           resMgr->setValue( mySection, myName, myValue );
1151       }
1152     }
1153   };
1154   ProcessVoidEvent( new TEvent( section, name, value ) );
1155 }
1156
1157 /*!
1158   \brief Add boolean setting to the application preferences.
1159   \param section resources file section name
1160   \param name setting name
1161   \param value new setting value
1162   \param dumb this parameter is used in order to avoid sip compilation error
1163   because of conflicting int and bool types
1164 */
1165 void SalomePyQt::addSetting( const QString& section, const QString& name, const bool value, const int /*dumb*/ )
1166 {
1167   class TEvent: public SALOME_Event
1168   {
1169     QString mySection;
1170     QString myName;
1171     bool    myValue;
1172   public:
1173     TEvent( const QString& section, const QString& name, bool value )
1174       : mySection( section ), myName( name ), myValue( value ) {}
1175     virtual void Execute()
1176     {
1177       if ( SUIT_Session::session() ) {
1178         SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1179         if ( !mySection.isEmpty() && !myName.isEmpty() )
1180           resMgr->setValue( mySection, myName, myValue );
1181       }
1182     }
1183   };
1184   ProcessVoidEvent( new TEvent( section, name, value ) );
1185 }
1186
1187 /*!
1188   \brief Add string setting to the application preferences.
1189   \param section resources file section name
1190   \param name setting name
1191   \param value new setting value
1192 */
1193 void SalomePyQt::addSetting( const QString& section, const QString& name, const QString& value )
1194 {
1195   class TEvent: public SALOME_Event
1196   {
1197     QString mySection;
1198     QString myName;
1199     QString myValue;
1200   public:
1201     TEvent( const QString& section, const QString& name, const QString& value )
1202       : mySection( section ), myName( name ), myValue( value ) {}
1203     virtual void Execute()
1204     {
1205       if ( SUIT_Session::session() ) {
1206         SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1207         if ( !mySection.isEmpty() && !myName.isEmpty() )
1208           resMgr->setValue( mySection, myName, myValue );
1209       }
1210     }
1211   };
1212   ProcessVoidEvent( new TEvent( section, name, value ) );
1213 }
1214
1215 /*!
1216   \brief Add color setting to the application preferences.
1217   \param section resources file section name
1218   \param name setting name
1219   \param value new setting value
1220 */
1221 void SalomePyQt::addSetting( const QString& section, const QString& name, const QColor& value )
1222 {
1223   class TEvent: public SALOME_Event
1224   {
1225     QString mySection;
1226     QString myName;
1227     QColor  myValue;
1228   public:
1229     TEvent( const QString& section, const QString& name, const QColor& value )
1230       : mySection( section ), myName( name ), myValue( value ) {}
1231     virtual void Execute()
1232     {
1233       if ( SUIT_Session::session() ) {
1234         SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1235         if ( !mySection.isEmpty() && !myName.isEmpty() )
1236           resMgr->setValue( mySection, myName, myValue );
1237       }
1238     }
1239   };
1240   ProcessVoidEvent( new TEvent( section, name, value ) );
1241 }
1242
1243 /*!
1244   \brief Add byte array setting to the application preferences.
1245   \param section resources file section name
1246   \param name setting name
1247   \param value new setting value
1248 */
1249 void SalomePyQt::addSetting( const QString& section, const QString& name, const QByteArray& value )
1250 {
1251   class TEvent: public SALOME_Event
1252   {
1253     QString    mySection;
1254     QString    myName;
1255     QByteArray myValue;
1256   public:
1257     TEvent( const QString& section, const QString& name, const QByteArray& value )
1258       : mySection( section ), myName( name ), myValue( value ) {}
1259     virtual void Execute()
1260     {
1261       if ( SUIT_Session::session() ) {
1262         SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1263         if ( !mySection.isEmpty() && !myName.isEmpty() )
1264           resMgr->setValue( mySection, myName, myValue );
1265       }
1266     }
1267   };
1268   ProcessVoidEvent( new TEvent( section, name, value ) );
1269 }
1270
1271 /*!
1272   \fn int SalomePyQt::integerSetting( const QString& section,
1273                                       const QString& name,
1274                                       const int def );
1275   \brief Get integer setting from the application preferences.
1276   \param section resources file section name
1277   \param name setting name
1278   \param def default value which is returned if the setting is not found
1279   \return setting value
1280 */
1281
1282 class TGetIntSettingEvent: public SALOME_Event
1283 {
1284 public:
1285   typedef int TResult;
1286   TResult myResult;
1287   QString mySection;
1288   QString myName;
1289   TResult myDefault;
1290   TGetIntSettingEvent( const QString& section, const QString& name, const int def )
1291     : mySection( section ), myName( name ), myDefault( def ) {}
1292   virtual void Execute()
1293   {
1294     if ( SUIT_Session::session() ) {
1295       SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1296       myResult = ( !mySection.isEmpty() && !myName.isEmpty() ) ? resMgr->integerValue( mySection, myName, myDefault ) : myDefault;
1297     }
1298   }
1299 };
1300 int SalomePyQt::integerSetting( const QString& section, const QString& name, const int def )
1301 {
1302   return ProcessEvent( new TGetIntSettingEvent( section, name, def ) );
1303 }
1304
1305 /*!
1306   \fn double SalomePyQt::doubleSetting( const QString& section,
1307                                         const QString& name,
1308                                         const double def );
1309   \brief Get double setting from the application preferences.
1310   \param section resources file section name
1311   \param name setting name
1312   \param def default value which is returned if the setting is not found
1313   \return setting value
1314 */
1315
1316 class TGetDblSettingEvent: public SALOME_Event
1317 {
1318 public:
1319   typedef double TResult;
1320   TResult myResult;
1321   QString mySection;
1322   QString myName;
1323   TResult myDefault;
1324   TGetDblSettingEvent( const QString& section, const QString& name, const double def )
1325     : mySection( section ), myName( name ), myDefault( def ) {}
1326   virtual void Execute()
1327   {
1328     if ( SUIT_Session::session() ) {
1329       SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1330       myResult = ( !mySection.isEmpty() && !myName.isEmpty() ) ? resMgr->doubleValue( mySection, myName, myDefault ) : myDefault;
1331     }
1332   }
1333 };
1334 double SalomePyQt::doubleSetting( const QString& section, const QString& name, const double def )
1335 {
1336   return ProcessEvent( new TGetDblSettingEvent( section, name, def ) );
1337 }
1338
1339 /*!
1340   \fn bool SalomePyQt::boolSetting( const QString& section,
1341                                     const QString& name,
1342                                     const bool def );
1343   \brief Get boolean setting from the application preferences.
1344   \param section resources file section name
1345   \param name setting name
1346   \param def default value which is returned if the setting is not found
1347   \return setting value
1348 */
1349
1350 class TGetBoolSettingEvent: public SALOME_Event
1351 {
1352 public:
1353   typedef bool TResult;
1354   TResult myResult;
1355   QString mySection;
1356   QString myName;
1357   TResult myDefault;
1358   TGetBoolSettingEvent( const QString& section, const QString& name, const bool def )
1359     : mySection( section ), myName( name ), myDefault( def ) {}
1360   virtual void Execute()
1361   {
1362     if ( SUIT_Session::session() ) {
1363       SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1364       myResult = ( !mySection.isEmpty() && !myName.isEmpty() ) ? resMgr->booleanValue( mySection, myName, myDefault ) : myDefault;
1365     }
1366   }
1367 };
1368 bool SalomePyQt::boolSetting( const QString& section, const QString& name, const bool def )
1369 {
1370   return ProcessEvent( new TGetBoolSettingEvent( section, name, def ) );
1371 }
1372
1373 /*!
1374   \fn QString SalomePyQt::stringSetting( const QString& section,
1375                                          const QString& name,
1376                                          const QString& def,
1377                                          const bool subst );
1378   \brief Get string setting from the application preferences.
1379   \param section resources file section name
1380   \param name setting name
1381   \param def default value which is returned if the setting is not found
1382   \param subst \c true to make substitution, \c false to get "raw" value
1383   \return setting value
1384 */
1385
1386 class TGetStrSettingEvent: public SALOME_Event
1387 {
1388 public:
1389   typedef QString TResult;
1390   TResult myResult;
1391   QString mySection;
1392   QString myName;
1393   bool mySubst;
1394   TResult myDefault;
1395   TGetStrSettingEvent( const QString& section, const QString& name, const QString& def, const bool subst )
1396     : mySection( section ), myName( name ), myDefault( def ), mySubst( subst ) {}
1397   virtual void Execute()
1398   {
1399     if ( SUIT_Session::session() ) {
1400       SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1401       myResult = ( !mySection.isEmpty() && !myName.isEmpty() ) ? resMgr->stringValue( mySection, myName, myDefault, mySubst ) : myDefault;
1402     }
1403   }
1404 };
1405 QString SalomePyQt::stringSetting( const QString& section, const QString& name, const QString& def, const bool subst )
1406 {
1407   return ProcessEvent( new TGetStrSettingEvent( section, name, def, subst ) );
1408 }
1409
1410 /*!
1411   \fn QColor SalomePyQt::colorSetting( const QString& section,
1412                                        const QString& name,
1413                                        const QColor def );
1414   \brief Get color setting from the application preferences.
1415   \param section resources file section name
1416   \param name setting name
1417   \param def default value which is returned if the setting is not found
1418   \return setting value
1419 */
1420
1421 class TGetColorSettingEvent: public SALOME_Event
1422 {
1423 public:
1424   typedef QColor TResult;
1425   TResult myResult;
1426   QString mySection;
1427   QString myName;
1428   TResult myDefault;
1429   TGetColorSettingEvent( const QString& section, const QString& name, const QColor& def )
1430     : mySection( section ), myName( name ), myDefault( def ) {}
1431   virtual void Execute()
1432   {
1433     if ( SUIT_Session::session() ) {
1434       SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1435       myResult = ( !mySection.isEmpty() && !myName.isEmpty() ) ? resMgr->colorValue( mySection, myName, myDefault ) : myDefault;
1436     }
1437   }
1438 };
1439 QColor SalomePyQt::colorSetting ( const QString& section, const QString& name, const QColor& def )
1440 {
1441   return ProcessEvent( new TGetColorSettingEvent( section, name, def ) );
1442 }
1443
1444 /*!
1445   \fn QByteArray SalomePyQt::byteArraySetting( const QString& section,
1446                                                const QString& name,
1447                                                const QByteArray def );
1448   \brief Get byte array setting from the application preferences.
1449   \param section resources file section name
1450   \param name setting name
1451   \param def default value which is returned if the setting is not found
1452   \return setting value
1453 */
1454
1455 class TGetByteArraySettingEvent: public SALOME_Event
1456 {
1457 public:
1458   typedef QByteArray TResult;
1459   TResult myResult;
1460   QString mySection;
1461   QString myName;
1462   TResult myDefault;
1463   TGetByteArraySettingEvent( const QString& section, const QString& name, const QByteArray& def )
1464     : mySection( section ), myName( name ), myDefault( def ) {}
1465   virtual void Execute()
1466   {
1467     if ( SUIT_Session::session() ) {
1468       SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1469       myResult = ( !mySection.isEmpty() && !myName.isEmpty() ) ? resMgr->byteArrayValue( mySection, myName, myDefault ) : myDefault;
1470     }
1471   }
1472 };
1473 QByteArray SalomePyQt::byteArraySetting ( const QString& section, const QString& name, const QByteArray& def )
1474 {
1475   return ProcessEvent( new TGetByteArraySettingEvent( section, name, def ) );
1476 }
1477
1478 /*!
1479   \brief Remove setting from the application preferences.
1480   \param section resources file section name
1481   \param name setting name
1482 */
1483 void SalomePyQt::removeSetting( const QString& section, const QString& name )
1484 {
1485   class TEvent: public SALOME_Event
1486   {
1487     QString mySection;
1488     QString myName;
1489   public:
1490     TEvent( const QString& section, const QString& name ) : mySection( section ), myName( name ) {}
1491     virtual void Execute()
1492     {
1493       if ( SUIT_Session::session() ) {
1494         SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1495         if ( !mySection.isEmpty() && !myName.isEmpty() )
1496           resMgr->remove( mySection, myName );
1497       }
1498     }
1499   };
1500   ProcessVoidEvent( new TEvent( section, name ) );
1501 }
1502
1503 /*!
1504   \fn bool SalomePyQt::hasSetting( const QString& section, const QString& name );
1505   \brief Check setting existence in the application preferences.
1506   \param section resources file section name
1507   \param name setting name
1508   \return \c true if setting exists
1509 */
1510
1511 class THasSettingEvent: public SALOME_Event
1512 {
1513 public:
1514   typedef bool TResult;
1515   TResult myResult;
1516   QString mySection;
1517   QString myName;
1518   THasSettingEvent( const QString& section, const QString& name )
1519     : mySection( section ), myName( name ) {}
1520   virtual void Execute()
1521   {
1522     if ( SUIT_Session::session() ) {
1523       SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1524       myResult = resMgr->hasValue( mySection, myName );
1525     }
1526   }
1527 };
1528 bool SalomePyQt::hasSetting( const QString& section, const QString& name )
1529 {
1530   return ProcessEvent( new THasSettingEvent( section, name ) );
1531 }
1532
1533 /*!
1534   \fn QStringList SalomePyQt::parameters( const QString& section );
1535   \brief Get names of preference items stored within the given section.
1536   \param section resources file section's name
1537   \return \c list of preferences items
1538 */
1539
1540 /*!
1541   \fn QStringList SalomePyQt::parameters( const QStringList& section );
1542   \brief Get names of preference items stored within the given section.
1543   \param section resources file section's name
1544   \return \c list of preferences items
1545 */
1546
1547 class TParametersEvent: public SALOME_Event
1548 {
1549 public:
1550   typedef QStringList TResult;
1551   TResult myResult;
1552   QStringList mySection;
1553   TParametersEvent( const QString& section )
1554   {
1555     mySection << section;
1556   }
1557   TParametersEvent( const QStringList& section )
1558     : mySection( section )
1559   {}
1560   virtual void Execute()
1561   {
1562     if ( SUIT_Session::session() ) {
1563       SUIT_ResourceMgr* resMgr = SUIT_Session::session()->resourceMgr();
1564       myResult = resMgr->parameters( mySection );
1565     }
1566   }
1567 };
1568 QStringList SalomePyQt::parameters( const QString& section )
1569 {
1570   return ProcessEvent( new TParametersEvent( section ) );
1571 }
1572 QStringList SalomePyQt::parameters( const QStringList& section )
1573 {
1574   return ProcessEvent( new TParametersEvent( section ) );
1575 }
1576
1577 /*!
1578   \fn QString SalomePyQt::getFileName( QWidget*           parent,
1579                                        const QString&     initial,
1580                                        const QStringList& filters,
1581                                        const QString&     caption,
1582                                        bool               open );
1583   \brief Show 'Open/Save file' dialog box for file selection
1584          and return a user's choice (selected file name).
1585   \param parent parent widget
1586   \param initial initial directory the dialog box to be opened in
1587   \param filters list of files filters (wildcards)
1588   \param caption dialog box title
1589   \param open if \c true, "Open File" dialog box is shown;
1590          otherwise "Save File" dialog box is shown
1591   \return selected file name (null string if user cancels operation)
1592 */
1593
1594 class TGetFileNameEvent: public SALOME_Event
1595 {
1596 public:
1597   typedef QString TResult;
1598   TResult     myResult;
1599   QWidget*    myParent;
1600   QString     myInitial;
1601   QStringList myFilters;
1602   QString     myCaption;
1603   bool        myOpen;
1604   TGetFileNameEvent( QWidget*           parent,
1605                      const QString&     initial,
1606                      const QStringList& filters,
1607                      const QString&     caption,
1608                      bool               open )
1609     : myParent ( parent ),
1610       myInitial( initial ),
1611       myFilters( filters ),
1612       myCaption( caption ),
1613       myOpen ( open ) {}
1614   virtual void Execute()
1615   {
1616     if ( LightApp_Application* anApp = getApplication() ) {
1617       myResult = anApp->getFileName( myOpen, myInitial, myFilters.join(";;"),
1618                                      myCaption, myParent );
1619     }
1620   }
1621 };
1622 QString SalomePyQt::getFileName( QWidget*           parent,
1623                                  const QString&     initial,
1624                                  const QStringList& filters,
1625                                  const QString&     caption,
1626                                  bool               open )
1627 {
1628   return ProcessEvent( new TGetFileNameEvent( parent, initial, filters, caption, open ) );
1629 }
1630
1631 /*!
1632   \fn QStringList SalomePyQt::getOpenFileNames( QWidget*           parent,
1633                                                 const QString&     initial,
1634                                                 const QStringList& filters,
1635                                                 const QString&     caption );
1636   \brief Show 'Open files' dialog box for multiple files selection
1637          and return a user's choice (selected file names list).
1638   \param parent parent widget
1639   \param initial initial directory the dialog box to be opened in
1640   \param filters list of files filters (wildcards)
1641   \param caption dialog box title
1642   \return selected file names list (empty list if user cancels operation)
1643 */
1644
1645 class TGetOpenFileNamesEvent: public SALOME_Event
1646 {
1647 public:
1648   typedef QStringList TResult;
1649   TResult     myResult;
1650   QWidget*    myParent;
1651   QString     myInitial;
1652   QStringList myFilters;
1653   QString     myCaption;
1654   TGetOpenFileNamesEvent( QWidget*           parent,
1655                           const QString&     initial,
1656                           const QStringList& filters,
1657                           const QString&     caption )
1658     : myParent ( parent ),
1659       myInitial( initial ),
1660       myFilters( filters ),
1661       myCaption( caption ) {}
1662   virtual void Execute()
1663   {
1664     if ( LightApp_Application* anApp = getApplication() ) {
1665       myResult = anApp->getOpenFileNames( myInitial, myFilters.join(";;"), myCaption, myParent );
1666     }
1667   }
1668 };
1669 QStringList SalomePyQt::getOpenFileNames( QWidget*           parent,
1670                                           const QString&     initial,
1671                                           const QStringList& filters,
1672                                           const QString&     caption )
1673 {
1674   return ProcessEvent( new TGetOpenFileNamesEvent( parent, initial, filters, caption ) );
1675 }
1676
1677 /*!
1678   \fn QString SalomePyQt::getExistingDirectory( QWidget*       parent,
1679                                                 const QString& initial,
1680                                                 const QString& caption );
1681   \brief Show 'Get Directory' dialog box for the directory selection
1682          and return a user's choice (selected directory name).
1683   \param parent parent widget
1684   \param initial initial directory the dialog box to be opened in
1685   \param caption dialog box title
1686   \return selected directory name (null string if user cancels operation)
1687 */
1688
1689 class TGetExistingDirectoryEvent: public SALOME_Event
1690 {
1691 public:
1692   typedef QString TResult;
1693   TResult     myResult;
1694   QWidget*    myParent;
1695   QString     myInitial;
1696   QString     myCaption;
1697   TGetExistingDirectoryEvent( QWidget*           parent,
1698                               const QString&     initial,
1699                               const QString&     caption )
1700     : myParent ( parent ),
1701       myInitial( initial ),
1702       myCaption( caption ) {}
1703   virtual void Execute()
1704   {
1705     if ( LightApp_Application* anApp = getApplication() ) {
1706       myResult = anApp->getDirectory( myInitial, myCaption, myParent );
1707     }
1708   }
1709 };
1710 QString SalomePyQt::getExistingDirectory( QWidget*       parent,
1711                                           const QString& initial,
1712                                           const QString& caption )
1713 {
1714   return ProcessEvent( new TGetExistingDirectoryEvent( parent, initial, caption ) );
1715 }
1716
1717 /*!
1718   \fn QString SalomePyQt::loadIcon( const QString& filename );
1719   \brief Load an icon from the module resources by the specified file name.
1720   \param fileName icon file name
1721   \return icon object
1722 */
1723
1724 class TLoadIconEvent: public SALOME_Event
1725 {
1726 public:
1727   typedef QIcon TResult;
1728   TResult     myResult;
1729   QString     myModule;
1730   QString     myFileName;
1731   TLoadIconEvent( const QString& module, const QString& filename )
1732     : myModule( module ),
1733       myFileName ( filename ) {}
1734   virtual void Execute()
1735   {
1736     myResult = loadIconInternal( myModule, myFileName );
1737   }
1738 };
1739 QIcon SalomePyQt::loadIcon( const QString& module, const QString& filename )
1740 {
1741   return ProcessEvent( new TLoadIconEvent( module, filename ) );
1742 }
1743
1744 /*!
1745   \brief Open external browser to display context help information.
1746   \todo
1747
1748   Current implementation does nothing.
1749
1750   \param source documentation (HTML) file name
1751   \param context context (for example, HTML ancor name)
1752 */
1753 void SalomePyQt::helpContext( const QString& source, const QString& context )
1754 {
1755   class TEvent: public SALOME_Event
1756   {
1757     QString mySource;
1758     QString myContext;
1759   public:
1760     TEvent( const QString& source, const QString& context )
1761       : mySource( source ), myContext( context ) {}
1762     virtual void Execute()
1763     {
1764       if ( LightApp_Application* anApp = getApplication() ) {
1765         anApp->onHelpContextModule( "", mySource, myContext );
1766       }
1767     }
1768   };
1769   ProcessVoidEvent( new TEvent( source, context ) );
1770 }
1771
1772 /*!
1773   \fn int SalomePyQt::defaultMenuGroup();
1774   \brief Get detault menu group identifier which can be used when
1775   creating menus (insert custom menu commands).
1776   \return default menu group ID
1777 */
1778
1779 class TDefMenuGroupEvent: public SALOME_Event
1780 {
1781 public:
1782   typedef int TResult;
1783   TResult myResult;
1784   TDefMenuGroupEvent() : myResult( -1 ) {}
1785   virtual void Execute()
1786   {
1787     myResult = PyModuleHelper::defaultMenuGroup();
1788   }
1789 };
1790 int SalomePyQt::defaultMenuGroup()
1791 {
1792   return ProcessEvent( new TDefMenuGroupEvent() );
1793 }
1794
1795 class CrTool
1796 {
1797 public:
1798   CrTool( const QString& tBar, const QString& nBar )
1799     : myCase( 0 ), myTbTitle( tBar ), myTbName( nBar)  {}
1800   CrTool( const int id, const int tBar, const int idx )
1801     : myCase( 1 ), myId( id ), myTbId( tBar ), myIndex( idx ) {}
1802   CrTool( const int id, const QString& tBar, const int idx )
1803     : myCase( 2 ), myId( id ), myTbTitle( tBar ), myIndex( idx ) {}
1804   CrTool( QAction* action, const int tbId, const int id, const int idx )
1805     : myCase( 3 ), myAction( action ), myTbId( tbId ), myId( id ), myIndex( idx ) {}
1806   CrTool( QAction* action, const QString& tBar, const int id, const int idx )
1807     : myCase( 4 ), myAction( action ), myTbTitle( tBar ), myId( id ), myIndex( idx ) {}
1808
1809   int execute( LightApp_Module* module ) const
1810   {
1811     if ( module ) {
1812       switch ( myCase ) {
1813       case 0:
1814         return module->createTool( myTbTitle, myTbName );
1815       case 1:
1816         return module->createTool( myId, myTbId, myIndex );
1817       case 2:
1818         return module->createTool( myId, myTbTitle, myIndex );
1819       case 3:
1820         return module->createTool( myAction, myTbId, myId, myIndex );
1821       case 4:
1822         return module->createTool( myAction, myTbTitle, myId, myIndex );
1823       }
1824     }
1825     return -1;
1826   }
1827 private:
1828    int        myCase;
1829    QString    myTbTitle;
1830    QString    myTbName;
1831    int        myTbId;
1832    QAction*   myAction;
1833    int        myId;
1834    int        myIndex;
1835 };
1836
1837 class TCreateToolEvent: public SALOME_Event
1838 {
1839 public:
1840   typedef int TResult;
1841   TResult myResult;
1842   const CrTool& myCrTool;
1843   TCreateToolEvent( const CrTool& crTool )
1844     : myResult( -1 ), myCrTool( crTool ) {}
1845   virtual void Execute()
1846   {
1847     LightApp_Module* module = getActiveModule();
1848     if ( module )
1849       myResult = myCrTool.execute( module );
1850   }
1851 };
1852
1853 /*!
1854   \brief Create toolbar with specified name.
1855   \param tBar toolbar title (language-dependent)
1856   \param nBar toolbar name (language-independent) [optional]
1857   \return toolbar ID or -1 if toolbar creation is failed
1858 */
1859 int SalomePyQt::createTool( const QString& tBar, const QString& nBar )
1860 {
1861   return ProcessEvent( new TCreateToolEvent( CrTool( tBar, nBar ) ) );
1862 }
1863
1864 /*!
1865   \brief Insert action with specified \a id to the toolbar.
1866   \param id action ID
1867   \param tBar toolbar ID
1868   \param idx required index in the toolbar
1869   \return action ID or -1 if action could not be added
1870 */
1871 int SalomePyQt::createTool( const int id, const int tBar, const int idx )
1872 {
1873   return ProcessEvent( new TCreateToolEvent( CrTool( id, tBar, idx ) ) );
1874 }
1875
1876 /*!
1877   \brief Insert action with specified \a id to the toolbar.
1878   \param id action ID
1879   \param tBar toolbar name
1880   \param idx required index in the toolbar
1881   \return action ID or -1 if action could not be added
1882 */
1883 int SalomePyQt::createTool( const int id, const QString& tBar, const int idx )
1884 {
1885   return ProcessEvent( new TCreateToolEvent( CrTool( id, tBar, idx ) ) );
1886 }
1887
1888 /*!
1889   \brief Insert action to the toolbar.
1890   \param a action
1891   \param tBar toolbar ID
1892   \param id required action ID
1893   \param idx required index in the toolbar
1894   \return action ID or -1 if action could not be added
1895 */
1896 int SalomePyQt::createTool( QAction* a, const int tBar, const int id, const int idx )
1897 {
1898   return ProcessEvent( new TCreateToolEvent( CrTool( a, tBar, id, idx ) ) );
1899 }
1900
1901 /*!
1902   \brief Insert action to the toolbar.
1903   \param a action
1904   \param tBar toolbar name
1905   \param id required action ID
1906   \param idx required index in the toolbar
1907   \return action ID or -1 if action could not be added
1908 */
1909 int SalomePyQt::createTool( QAction* a, const QString& tBar, const int id, const int idx )
1910 {
1911   return ProcessEvent( new TCreateToolEvent( CrTool( a, tBar, id, idx ) ) );
1912 }
1913
1914 class CrMenu
1915 {
1916 public:
1917   CrMenu( const QString& subMenu, const int menu, const int id, const int group, const int idx )
1918     : myCase( 0 ), mySubMenuName( subMenu ), myMenuId( menu ), myId( id ), myGroup( group ), myIndex( idx ) {}
1919   CrMenu( const QString& subMenu, const QString& menu, const int id, const int group, const int idx )
1920     : myCase( 1 ), mySubMenuName( subMenu ), myMenuName( menu ), myId( id ), myGroup( group ), myIndex( idx ) {}
1921   CrMenu( const int id, const int menu, const int group, const int idx )
1922     : myCase( 2 ), myId( id ), myMenuId( menu ), myGroup( group ), myIndex( idx ) {}
1923   CrMenu( const int id, const QString& menu, const int group, const int idx )
1924     : myCase( 3 ), myId( id ), myMenuName( menu ), myGroup( group ), myIndex( idx ) {}
1925   CrMenu( QAction* action, const int menu, const int id, const int group, const int idx )
1926     : myCase( 4 ), myAction( action ), myMenuId( menu ), myId( id ), myGroup( group ), myIndex( idx ) {}
1927   CrMenu( QAction* action, const QString& menu, const int id, const int group, const int idx )
1928     : myCase( 5 ), myAction( action ), myMenuName( menu ), myId( id ), myGroup( group ), myIndex( idx ) {}
1929
1930   int execute( LightApp_Module* module ) const
1931   {
1932     if ( module ) {
1933       switch ( myCase ) {
1934       case 0:
1935         return module->createMenu( mySubMenuName, myMenuId, myId, myGroup, myIndex );
1936       case 1:
1937         return module->createMenu( mySubMenuName, myMenuName, myId, myGroup, myIndex );
1938       case 2:
1939         return module->createMenu( myId, myMenuId, myGroup, myIndex );
1940       case 3:
1941         return module->createMenu( myId, myMenuName, myGroup, myIndex );
1942       case 4:
1943         return module->createMenu( myAction, myMenuId, myId, myGroup, myIndex );
1944       case 5:
1945         return module->createMenu( myAction, myMenuName, myId, myGroup, myIndex );
1946       }
1947     }
1948     return -1;
1949   }
1950 private:
1951    int        myCase;
1952    QString    myMenuName;
1953    int        myMenuId;
1954    QString    mySubMenuName;
1955    int        myGroup;
1956    QAction*   myAction;
1957    int        myId;
1958    int        myIndex;
1959 };
1960
1961 class TCreateMenuEvent: public SALOME_Event
1962 {
1963 public:
1964   typedef int TResult;
1965   TResult myResult;
1966   const CrMenu& myCrMenu;
1967   TCreateMenuEvent( const CrMenu& crMenu )
1968     : myResult( -1 ), myCrMenu( crMenu ) {}
1969   virtual void Execute()
1970   {
1971     LightApp_Module* module = getActiveModule();
1972     if ( module )
1973       myResult = myCrMenu.execute( module );
1974   }
1975 };
1976
1977 /*!
1978   \brief Create main menu.
1979   \param subMenu menu name
1980   \param menu parent menu ID
1981   \param id required menu ID
1982   \param group menu group ID
1983   \param idx required index in the menu
1984   \return menu ID or -1 if menu could not be added
1985 */
1986 int SalomePyQt::createMenu( const QString& subMenu, const int menu, const int id, const int group, const int idx )
1987 {
1988   return ProcessEvent( new TCreateMenuEvent( CrMenu( subMenu, menu, id, group, idx ) ) );
1989 }
1990
1991 /*!
1992   \brief Create main menu.
1993   \param subMenu menu name
1994   \param menu parent menu name (list of menu names separated by "|")
1995   \param id required menu ID
1996   \param group menu group ID
1997   \param idx required index in the menu
1998   \return menu ID or -1 if menu could not be added
1999 */
2000 int SalomePyQt::createMenu( const QString& subMenu, const QString& menu, const int id, const int group, const int idx )
2001 {
2002   return ProcessEvent( new TCreateMenuEvent( CrMenu( subMenu, menu, id, group, idx ) ) );
2003 }
2004
2005 /*!
2006   \brief Insert action to the main menu.
2007   \param id action ID
2008   \param menu parent menu ID
2009   \param group menu group ID
2010   \param idx required index in the menu
2011   \return action ID or -1 if action could not be added
2012 */
2013 int SalomePyQt::createMenu( const int id, const int menu, const int group, const int idx )
2014 {
2015   return ProcessEvent( new TCreateMenuEvent( CrMenu( id, menu, group, idx ) ) );
2016 }
2017
2018 /*!
2019   \brief Insert action to the main menu.
2020   \param id action ID
2021   \param menu parent menu name (list of menu names separated by "|")
2022   \param group menu group ID
2023   \param idx required index in the menu
2024   \return action ID or -1 if action could not be added
2025 */
2026 int SalomePyQt::createMenu( const int id, const QString& menu, const int group, const int idx )
2027 {
2028   return ProcessEvent( new TCreateMenuEvent( CrMenu( id, menu, group, idx ) ) );
2029 }
2030
2031 /*!
2032   \brief Insert action to the main menu.
2033   \param a action
2034   \param menu parent menu ID
2035   \param group menu group ID
2036   \param idx required index in the menu
2037   \return action ID or -1 if action could not be added
2038 */
2039 int SalomePyQt::createMenu( QAction* a, const int menu, const int id, const int group, const int idx )
2040 {
2041   return ProcessEvent( new TCreateMenuEvent( CrMenu( a, menu, id, group, idx ) ) );
2042 }
2043
2044 /*!
2045   \brief Insert action to the main menu.
2046   \param a action
2047   \param menu parent menu name (list of menu names separated by "|")
2048   \param group menu group ID
2049   \param idx required index in the menu
2050   \return action ID or -1 if action could not be added
2051 */
2052 int SalomePyQt::createMenu( QAction* a, const QString& menu, const int id, const int group, const int idx )
2053 {
2054   return ProcessEvent( new TCreateMenuEvent( CrMenu( a, menu, id, group, idx ) ) );
2055 }
2056
2057 /*!
2058   \fn QAction* SalomePyQt::createSeparator();
2059   \brief Create separator action which can be used in the menu or toolbar.
2060   \return new separator action
2061 */
2062
2063 class TCreateSepEvent: public SALOME_Event
2064 {
2065 public:
2066   typedef QAction* TResult;
2067   TResult myResult;
2068   TCreateSepEvent()
2069     : myResult( 0 ) {}
2070   virtual void Execute()
2071   {
2072     LightApp_Module* module = getActiveModule();
2073     if ( module )
2074       myResult = (QAction*)module->separator();
2075   }
2076 };
2077 QAction* SalomePyQt::createSeparator()
2078 {
2079   return ProcessEvent( new TCreateSepEvent() );
2080 }
2081
2082 /*!
2083   \fn QAction* SalomePyQt::createAction( const int      id,
2084                                          const QString& menuText,
2085                                          const QString& tipText,
2086                                          const QString& statusText,
2087                                          const QString& icon,
2088                                          const int      key,
2089                                          const bool     toggle );
2090   \brief Create an action which can be then used in the menu or toolbar.
2091   \param id the unique id action to be registered to
2092   \param menuText action text which should appear in menu
2093   \param tipText text which should appear in the tooltip
2094   \param statusText text which should appear in the status bar when action is activated
2095   \param icon the name of the icon file (the actual icon file name can be coded in the translation files)
2096   \param key the key accelrator for the action
2097   \param toggle if \c true the action is checkable
2098 */
2099
2100 class TCreateActionEvent: public SALOME_Event
2101 {
2102 public:
2103   typedef QAction* TResult;
2104   TResult myResult;
2105   int     myId;
2106   QString myMenuText;
2107   QString myTipText;
2108   QString myStatusText;
2109   QString myIcon;
2110   int     myKey;
2111   bool    myToggle;
2112   TCreateActionEvent( const int id, const QString& menuText, const QString& tipText,
2113                       const QString& statusText, const QString& icon, const int key, const bool toggle )
2114     : myResult( 0 ), myId( id ), myMenuText( menuText ), myTipText( tipText ),
2115       myStatusText( statusText ), myIcon( icon ), myKey( key ), myToggle( toggle ) {}
2116   virtual void Execute()
2117   {
2118     LightApp_Module* module = getActiveModule();
2119     if ( module ) {
2120       QIcon icon = loadIconInternal( module->name(), myIcon );
2121       myResult = (QAction*)module->action( myId );
2122       if ( myResult ) {
2123         if ( myResult->toolTip().isEmpty() && !myTipText.isEmpty() )
2124           myResult->setToolTip( myTipText );
2125         if ( myResult->text().isEmpty() && !myMenuText.isEmpty() )
2126           myResult->setText( myMenuText );
2127         if ( myResult->icon().isNull() && !icon.isNull() )
2128           myResult->setIcon( icon );
2129         if ( myResult->statusTip().isEmpty() && !myStatusText.isEmpty() )
2130           myResult->setStatusTip( myStatusText );
2131         if ( myResult->shortcut().isEmpty() && myKey )
2132           myResult->setShortcut( myKey );
2133         if ( myResult->isCheckable() != myToggle )
2134           myResult->setCheckable( myToggle );
2135       }
2136       else {
2137         myResult = (QAction*)module->createAction( myId, myTipText, icon, myMenuText, myStatusText, myKey, module, myToggle );
2138       }
2139       // for Python module, automatically connect action to callback slot
2140       PyModuleHelper* helper = module->findChild<PyModuleHelper*>( "python_module_helper" );
2141       if ( helper ) helper->connectAction( myResult );
2142     }
2143   }
2144 };
2145 QAction* SalomePyQt::createAction( const int id,           const QString& menuText,
2146                                    const QString& tipText, const QString& statusText,
2147                                    const QString& icon,    const int key, const bool toggle )
2148 {
2149   return ProcessEvent( new TCreateActionEvent( id, menuText, tipText, statusText, icon, key, toggle ) );
2150 }
2151
2152 /*!
2153   \fn QtxActionGroup* SalomePyQt::createActionGroup( const int id, const bool exclusive );
2154   \brief Create an action group which can be then used in the menu or toolbar
2155   \param id         : the unique id action group to be registered to
2156   \param exclusive  : if \c true the action group does exclusive toggling
2157 */
2158
2159 struct TCreateActionGroupEvent: public SALOME_Event
2160 {
2161   typedef QtxActionGroup* TResult;
2162   TResult myResult;
2163   int     myId;
2164   bool    myExclusive;
2165   TCreateActionGroupEvent( const int id, const bool exclusive )
2166     : myId( id ), myExclusive( exclusive ) {}
2167   virtual void Execute()
2168   {
2169     LightApp_Module* module = getActiveModule();
2170     if ( module )
2171       myResult = module->createActionGroup( myId, myExclusive );
2172   }
2173 };
2174 QtxActionGroup* SalomePyQt::createActionGroup( const int id, const bool exclusive )
2175 {
2176   return ProcessEvent( new TCreateActionGroupEvent( id, exclusive ) );
2177 }
2178
2179 /*!
2180   \fn QAction* SalomePyQt::action( const int id );
2181   \brief Get action by specified identifier.
2182   \return action or 0 if action is not registered
2183 */
2184
2185 class TActionEvent: public SALOME_Event
2186 {
2187 public:
2188   typedef QAction* TResult;
2189   TResult myResult;
2190   int     myId;
2191   TActionEvent( const int id )
2192     : myResult( 0 ), myId( id ) {}
2193   virtual void Execute()
2194   {
2195     LightApp_Module* module = getActiveModule();
2196     if ( module )
2197       myResult = (QAction*)module->action( myId );
2198   }
2199 };
2200 QAction* SalomePyQt::action( const int id )
2201 {
2202   return ProcessEvent( new TActionEvent( id ) );
2203 }
2204
2205 /*!
2206   \fn int SalomePyQt::actionId( const QAction* a );
2207   \brief Get an action identifier.
2208   \return action ID or -1 if action is not registered
2209 */
2210
2211 class TActionIdEvent: public SALOME_Event
2212 {
2213 public:
2214   typedef  int TResult;
2215   TResult  myResult;
2216   const QAction* myAction;
2217   TActionIdEvent( const QAction* action )
2218     : myResult( -1 ), myAction( action ) {}
2219   virtual void Execute()
2220   {
2221     LightApp_Module* module = getActiveModule();
2222     if ( module )
2223       myResult = module->actionId( myAction );
2224   }
2225 };
2226 int SalomePyQt::actionId( const QAction* a )
2227 {
2228   return ProcessEvent( new TActionIdEvent( a ) );
2229 }
2230
2231 /*!
2232   \fn int SalomePyQt::addGlobalPreference( const QString& label );
2233   \brief Add global (not module-related) preferences group.
2234   \param label global preferences group name
2235   \return preferences group identifier
2236 */
2237
2238 class TAddGlobalPrefEvent: public SALOME_Event
2239 {
2240 public:
2241   typedef int TResult;
2242   TResult myResult;
2243   QString myLabel;
2244   TAddGlobalPrefEvent( const QString& label )
2245     : myResult( -1 ), myLabel( label ) {}
2246   virtual void Execute()
2247   {
2248     LightApp_Module* module = getActiveModule();
2249     if ( module ) {
2250       LightApp_Preferences* pref = module->getApp()->preferences();
2251       if ( pref )
2252         myResult = pref->addPreference( myLabel, -1 );
2253     }
2254   }
2255 };
2256 int SalomePyQt::addGlobalPreference( const QString& label )
2257 {
2258   return ProcessEvent( new TAddGlobalPrefEvent( label ) );
2259 }
2260
2261 /*!
2262   \fn int SalomePyQt::addPreference( const QString& label );
2263   \brief Add module-related preferences group.
2264   \param label preferences group name
2265   \return preferences group identifier
2266 */
2267
2268 class TAddPrefEvent: public SALOME_Event
2269 {
2270 public:
2271   typedef int TResult;
2272   TResult myResult;
2273   QString myLabel;
2274   TAddPrefEvent( const QString& label )
2275     : myResult( -1 ), myLabel( label ) {}
2276   virtual void Execute()
2277   {
2278     LightApp_Module* module = getActiveModule();
2279     if ( module ) {
2280       LightApp_Preferences* pref = module->getApp()->preferences();
2281       if ( pref ) {
2282         int cId = pref->addPreference( module->moduleName(), -1 );
2283         if ( cId != -1 )
2284           myResult = pref->addPreference( myLabel, cId );
2285       }
2286     }
2287   }
2288 };
2289 int SalomePyQt::addPreference( const QString& label )
2290 {
2291   return ProcessEvent( new TAddPrefEvent( label ) );
2292 }
2293
2294 /*!
2295   \fn int SalomePyQt::addPreference( const QString& label, const int pId, const int type,
2296                                      const QString& section, const QString& param );
2297   \brief Add module-related preferences.
2298   \param label preferences group name
2299   \param pId parent preferences group id
2300   \param type preferences type
2301   \param section resources file section name
2302   \param param resources file setting name
2303   \return preferences identifier
2304 */
2305
2306 class TAddPrefParamEvent: public SALOME_Event
2307 {
2308 public:
2309   typedef int TResult;
2310   TResult myResult;
2311   QString myLabel;
2312   int     myPId;
2313   int     myType;
2314   QString mySection;
2315   QString myParam;
2316   TAddPrefParamEvent( const QString& label,
2317                       const int pId, const int type,
2318                       const QString& section,
2319                       const QString& param )
2320     : myResult( -1 ),
2321       myLabel( label ), myPId( pId ), myType( type ),
2322       mySection( section ), myParam ( param ) {}
2323   virtual void Execute()
2324   {
2325     LightApp_Module* module = getActiveModule();
2326     if ( module ) {
2327       LightApp_Preferences* pref = module->getApp()->preferences();
2328       if ( pref )
2329         myResult = pref->addPreference( module->moduleName(), myLabel, myPId, myType, mySection, myParam );
2330     }
2331   }
2332 };
2333 int SalomePyQt::addPreference( const QString& label, const int pId, const int type,
2334                                const QString& section, const QString& param )
2335 {
2336   return ProcessEvent( new TAddPrefParamEvent( label, pId, type, section, param ) );
2337 }
2338
2339 /*!
2340   \fn QVariant SalomePyQt::preferenceProperty( const int id, const QString& prop );
2341   \brief Get the preferences property.
2342   \param id preferences identifier
2343   \param prop preferences property name
2344   \return preferences property value or null QVariant if property is not set
2345 */
2346
2347 class TPrefPropEvent: public SALOME_Event
2348 {
2349 public:
2350   typedef QVariant TResult;
2351   TResult myResult;
2352   int     myId;
2353   QString myProp;
2354   TPrefPropEvent( const int id, const QString& prop )
2355     : myId( id ), myProp( prop ) {}
2356   virtual void Execute()
2357   {
2358     LightApp_Module* module = getActiveModule();
2359     if ( module ) {
2360       LightApp_Preferences* pref = module->getApp()->preferences();
2361       if ( pref )
2362         myResult = pref->itemProperty( myProp, myId );
2363     }
2364   }
2365 };
2366 QVariant SalomePyQt::preferenceProperty( const int id, const QString& prop )
2367 {
2368   return ProcessEvent( new TPrefPropEvent( id, prop ) );
2369 }
2370
2371 /*!
2372   \brief Set the preferences property.
2373   \param id preferences identifier
2374   \param prop preferences property name
2375   \param var preferences property value
2376 */
2377 void SalomePyQt::setPreferenceProperty( const int id,
2378                                         const QString& prop,
2379                                         const QVariant& var )
2380 {
2381   class TEvent: public SALOME_Event
2382   {
2383     int      myId;
2384     QString  myProp;
2385     QVariant myVar;
2386   public:
2387     TEvent( const int id, const QString& prop, const QVariant& var )
2388       : myId( id ), myProp( prop ), myVar( var ) {}
2389     virtual void Execute()
2390     {
2391       LightApp_Module* module = getActiveModule();
2392       if ( module ) {
2393         LightApp_Preferences* pref = module->getApp()->preferences();
2394         if ( pref )
2395           pref->setItemProperty( myProp, myVar, myId );
2396       }
2397     }
2398   };
2399   ProcessVoidEvent( new TEvent( id, prop, var) );
2400 }
2401
2402 /*!
2403   \brief Add the property value to the list of values.
2404
2405   This method allows creating properties which are QList<QVariant>
2406   - there is no way to pass such values directly to QVariant parameter with PyQt.
2407
2408   \param id preferences identifier
2409   \param prop preferences property name
2410   \param idx preferences property index
2411   \param var preferences property value for the index \a idx
2412 */
2413 void SalomePyQt::addPreferenceProperty( const int id,
2414                                         const QString& prop,
2415                                         const int idx,
2416                                         const QVariant& var )
2417 {
2418   class TEvent: public SALOME_Event
2419   {
2420     int      myId;
2421     QString  myProp;
2422     int      myIdx;
2423     QVariant myVar;
2424   public:
2425     TEvent( const int id, const QString& prop, const int idx, const QVariant& var )
2426       : myId( id ), myProp( prop ), myIdx( idx), myVar( var ) {}
2427     virtual void Execute()
2428     {
2429       LightApp_Module* module = getActiveModule();
2430       if ( module ) {
2431         LightApp_Preferences* pref = module->getApp()->preferences();
2432         if ( pref ) {
2433           QVariant var =  pref->itemProperty( myProp, myId );
2434           if ( var.isValid() ) {
2435             if ( var.type() == QVariant::StringList ) {
2436               QStringList sl = var.toStringList();
2437               if ( myIdx >= 0 && myIdx < sl.count() )
2438                 sl[myIdx] = myVar.toString();
2439               else
2440                 sl.append( myVar.toString() );
2441               pref->setItemProperty( myProp, sl, myId );
2442             }
2443             else if ( var.type() == QVariant::List ) {
2444               QList<QVariant> vl = var.toList();
2445               if ( myIdx >= 0 && myIdx < vl.count() )
2446                 vl[myIdx] = myVar;
2447               else
2448                 vl.append( myVar );
2449               pref->setItemProperty( myProp, vl, myId );
2450             }
2451           }
2452           else {
2453             QList<QVariant> vl;
2454             vl.append( myVar );
2455             pref->setItemProperty( myProp, vl, myId );
2456           }
2457         }
2458       }
2459     }
2460   };
2461   ProcessVoidEvent( new TEvent( id, prop, idx, var) );
2462 }
2463
2464 /*!
2465   \brief Put the message to the Log messages output window
2466   \param msg message text (it can be of simple rich text format)
2467   \param addSeparator boolean flag which specifies if it is necessary
2468          to separate the message with predefined separator
2469 */
2470 void SalomePyQt::message( const QString& msg, bool addSeparator )
2471 {
2472   class TEvent: public SALOME_Event
2473   {
2474     QString  myMsg;
2475     bool     myAddSep;
2476   public:
2477     TEvent( const QString& msg, bool addSeparator )
2478       : myMsg( msg ), myAddSep( addSeparator ) {}
2479     virtual void Execute()
2480     {
2481       if ( LightApp_Application* anApp = getApplication() ) {
2482         LogWindow* lw = anApp->logWindow();
2483         if ( lw )
2484           lw->putMessage( myMsg, myAddSep );
2485       }
2486     }
2487   };
2488   ProcessVoidEvent( new TEvent( msg, addSeparator ) );
2489 }
2490
2491 /*!
2492   \brief Remove all the messages from the Log messages output window.
2493 */
2494 void SalomePyQt::clearMessages()
2495 {
2496   class TEvent: public SALOME_Event
2497   {
2498   public:
2499     TEvent() {}
2500     virtual void Execute()
2501     {
2502       if ( LightApp_Application* anApp = getApplication() ) {
2503         LogWindow* lw = anApp->logWindow();
2504         if ( lw )
2505           lw->clear();
2506       }
2507     }
2508   };
2509   ProcessVoidEvent( new TEvent() );
2510 }
2511
2512 /*!
2513   \fn bool SalomePyQt::dumpView( const QString& filename, const int id = 0 );
2514   \brief Dump the contents of the id view window. If id is 0 then current active view is processed.
2515   to the image file in the specified format.
2516
2517   For the current moment JPEG, PNG and BMP images formats are supported.
2518   The image format is defined automatically by the file name extension.
2519   By default, BMP format is used.
2520
2521   \param filename image file name
2522   \return operation status (\c true on success)
2523 */
2524
2525 class TDumpViewEvent: public SALOME_Event
2526 {
2527 public:
2528   typedef bool TResult;
2529   TResult myResult;
2530   QString myFileName;
2531   int myWndId;
2532   TDumpViewEvent( const QString& filename, const int id )
2533     : myResult ( false ), myFileName( filename ), myWndId( id ) {}
2534   virtual void Execute()
2535   {
2536     SUIT_ViewWindow* wnd = 0;
2537     if ( !myWndId ) {
2538       if ( LightApp_Application* anApp = getApplication() ) {
2539         SUIT_ViewManager* vm = anApp->activeViewManager();
2540         if ( vm )
2541           wnd = vm->getActiveView();
2542       }
2543       myWndId = wnd->getId();
2544     }
2545     else {
2546       wnd = dynamic_cast<SUIT_ViewWindow*>( getWnd( myWndId ) );
2547     }
2548     if ( wnd ) {
2549       QString fmt = SUIT_Tools::extension( myFileName ).toUpper();
2550 #ifndef DISABLE_PLOT2DVIEWER
2551       Plot2d_ViewWindow* wnd2D = dynamic_cast<Plot2d_ViewWindow*>( wnd );
2552       if ( wnd2D ) {
2553         qApp->postEvent( wnd2D->getViewFrame(), new QPaintEvent( QRect( 0, 0, wnd2D->getViewFrame()->width(), wnd2D->getViewFrame()->height() ) ) );
2554         qApp->postEvent( wnd2D, new QPaintEvent( QRect( 0, 0, wnd2D->width(), wnd2D->height() ) ) );
2555         qApp->processEvents();
2556         if ( fmt == "PS" || fmt == "EPS" || fmt == "PDF" ) {
2557           myResult = wnd2D->getViewFrame()->print( myFileName, fmt );
2558           return;
2559         }
2560       }
2561 #endif // DISABLE_PLOT2DVIEWER
2562       QImage im = wnd->dumpView();
2563       if ( !im.isNull() && !myFileName.isEmpty() ) {
2564         if ( fmt.isEmpty() ) fmt = QString( "BMP" ); // default format
2565         if ( fmt == "JPG" )  fmt = "JPEG";
2566         myResult = im.save( myFileName, fmt.toLatin1() );
2567       }
2568     }
2569   }
2570 };
2571 bool SalomePyQt::dumpView( const QString& filename, const int id )
2572 {
2573   return ProcessEvent( new TDumpViewEvent( filename, id ) );
2574 }
2575
2576 /*!
2577   \fn QList<int> SalomePyQt::getViews();
2578   \brief Get list of integer identifiers of all the currently opened views
2579   \return list of integer identifiers of all the currently opened views
2580 */
2581
2582 class TGetViews: public SALOME_Event
2583 {
2584 public:
2585   typedef QList<int> TResult;
2586   TResult myResult;
2587   TGetViews() {}
2588   virtual void Execute()
2589   {
2590     myResult.clear();
2591     LightApp_Application* app  = getApplication();
2592     if ( app ) {
2593       STD_TabDesktop* tabDesk = dynamic_cast<STD_TabDesktop*>( app->desktop() );
2594       if ( tabDesk ) {
2595         QList<SUIT_ViewWindow*> wndlist = tabDesk->windows();
2596         SUIT_ViewWindow* wnd;
2597         foreach ( wnd, wndlist )
2598           myResult.append( wnd->getId() );
2599       }
2600     }
2601   }
2602 };
2603 QList<int> SalomePyQt::getViews()
2604 {
2605   return ProcessEvent( new TGetViews() );
2606 }
2607
2608 /*!
2609   \fn int SalomePyQt::getActiveView();
2610   \brief Get integer identifier of the currently active view
2611   \return integer identifier of the currently active view
2612 */
2613
2614 class TGetActiveView: public SALOME_Event
2615 {
2616 public:
2617   typedef int TResult;
2618   TResult myResult;
2619   TGetActiveView()
2620     : myResult( -1 ) {}
2621   virtual void Execute()
2622   {
2623     LightApp_Application* app = getApplication();
2624     if ( app ) {
2625       SUIT_ViewManager* viewMgr = app->activeViewManager();
2626       if ( viewMgr ) {
2627         SUIT_ViewWindow* wnd = viewMgr->getActiveView();
2628         if ( wnd )
2629           myResult = wnd->getId();
2630       }
2631     }
2632   }
2633 };
2634 int SalomePyQt::getActiveView()
2635 {
2636   return ProcessEvent( new TGetActiveView() );
2637 }
2638
2639 /*!
2640   \fn QString SalomePyQt::getViewType( const int id );
2641   \brief Get type of the specified view, e.g. "OCCViewer"
2642   \param id window identifier
2643   \return view type
2644 */
2645
2646 class TGetViewType: public SALOME_Event
2647 {
2648 public:
2649   typedef QString TResult;
2650   TResult myResult;
2651   int myWndId;
2652   TGetViewType( const int id )
2653     : myWndId( id ) {}
2654   virtual void Execute()
2655   {
2656     SUIT_ViewWindow* wnd = getWnd( myWndId );
2657     if ( wnd ) {
2658       SUIT_ViewManager* viewMgr = wnd->getViewManager();
2659       if ( viewMgr )
2660         myResult = viewMgr->getType();
2661     }
2662   }
2663 };
2664 QString SalomePyQt::getViewType( const int id )
2665 {
2666   return ProcessEvent( new TGetViewType( id ) );
2667 }
2668
2669 /*!
2670   \fn bool SalomePyQt::setViewTitle( const int id, const QString& title );
2671   \brief Change view caption
2672   \param id window identifier
2673   \param title new window title
2674   \return \c true if operation is completed successfully and \c false otherwise
2675 */
2676
2677 class TSetViewTitle: public SALOME_Event
2678 {
2679 public:
2680   typedef bool TResult;
2681   TResult myResult;
2682   int myWndId;
2683   QString myTitle;
2684   TSetViewTitle( const int id, const QString& title )
2685     : myResult( false ),
2686       myWndId( id ),
2687       myTitle( title ) {}
2688   virtual void Execute()
2689   {
2690     SUIT_ViewWindow* wnd = getWnd( myWndId );
2691     if ( wnd ) {
2692       wnd->setWindowTitle( myTitle );
2693       myResult = true;
2694     }
2695   }
2696 };
2697 bool SalomePyQt::setViewTitle( const int id, const QString& title )
2698 {
2699   return ProcessEvent( new TSetViewTitle( id, title ) );
2700 }
2701
2702 /*!
2703   \fn bool SalomePyQt::setViewSize( const int w, const int h, const int id );
2704   \brief Set view size
2705   \param w window width
2706   \param h window height
2707   \param id window identifier
2708   \return \c true if operation is completed successfully and \c false otherwise
2709 */
2710
2711 class TSetViewSize: public SALOME_Event
2712 {
2713 public:
2714   typedef bool TResult;
2715   TResult myResult;
2716   int myWndWidth;
2717   int myWndHeight;
2718   int myWndId;
2719   TSetViewSize( const int w, const int h, const int id )
2720     : myResult( false ),
2721       myWndWidth( w ),
2722       myWndHeight( h ),
2723       myWndId( id ) {}
2724   virtual void Execute()
2725   {
2726     SUIT_ViewWindow* wnd = 0;
2727     if ( !myWndId ) {
2728       if ( LightApp_Application* anApp = getApplication() ) {
2729         SUIT_ViewManager* vm = anApp->activeViewManager();
2730         if ( vm )
2731           wnd = vm->getActiveView();
2732       }
2733     }
2734     else {
2735       wnd = dynamic_cast<SUIT_ViewWindow*>( getWnd( myWndId ) );
2736     }
2737     if ( wnd ) {
2738       SUIT_ViewManager* viewMgr = wnd->getViewManager();
2739       if ( viewMgr ) {
2740         QString type = viewMgr->getType();
2741         if ( type == "OCCViewer") {
2742 #ifndef DISABLE_OCCVIEWER
2743           // specific processing for OCC viewer:
2744           // OCC view can embed up to 4 sub-views, split according to the specified layout;
2745           // - if there is only one sub-view active; it will be resized;
2746           // - if there are several sub-views, each of them will be resized.
2747           OCCViewer_ViewWindow* occView = qobject_cast<OCCViewer_ViewWindow*>( wnd );
2748           for ( int i = OCCViewer_ViewFrame::BOTTOM_RIGHT; i <= OCCViewer_ViewFrame::TOP_RIGHT; i++ ) {
2749             if ( occView && occView->getView( i ) ) {
2750               occView->getView( i )->centralWidget()->resize( myWndWidth, myWndHeight );
2751               myResult = true;
2752             }
2753           }
2754 #endif // DISABLE_OCCVIEWER
2755         }
2756         else if ( type == "ParaView") {
2757 #ifndef DISABLE_PVVIEWER
2758           // specific processing for ParaView viewer:
2759           // hierarchy of ParaView viewer is much complex than for usual view;
2760           // we look for sub-widget named "Viewport"
2761           QList<QWidget*> lst = wnd->findChildren<QWidget*>( "Viewport" );
2762           if ( !lst.isEmpty() ) {
2763             lst[0]->resize( myWndWidth, myWndHeight );
2764             myResult = true;
2765           }
2766 #endif // DISABLE_PVVIEWER
2767         }
2768         else {
2769           if ( wnd->centralWidget() ) {
2770             wnd->centralWidget()->resize( myWndWidth, myWndHeight );
2771             myResult = true;
2772           }
2773         }
2774       }
2775     }
2776   }
2777 };
2778 bool SalomePyQt::setViewSize( const int w, const int h, const int id )
2779 {
2780   return ProcessEvent( new TSetViewSize( w, h, id ) );
2781 }
2782
2783 /*!
2784   \fn QString SalomePyQt::getViewTitle( const int id );
2785   \brief Get view caption
2786   \param id window identifier
2787   \return view caption
2788 */
2789
2790 class TGetViewTitle: public SALOME_Event
2791 {
2792 public:
2793   typedef QString TResult;
2794   TResult myResult;
2795   int myWndId;
2796   TGetViewTitle( const int id )
2797     : myWndId( id ) {}
2798   virtual void Execute()
2799   {
2800     SUIT_ViewWindow* wnd = getWnd( myWndId );
2801     if ( wnd )
2802       myResult = wnd->windowTitle();
2803   }
2804 };
2805 QString SalomePyQt::getViewTitle( const int id )
2806 {
2807   return ProcessEvent( new TGetViewTitle( id ) );
2808 }
2809
2810 /*!
2811   \fn QList<int> SalomePyQt::findViews( const QString& type );
2812   \brief Get list of integer identifiers of all the
2813          currently opened views of the specified type
2814   \param type viewer type
2815   \return list of integer identifiers
2816 */
2817
2818 class TFindViews: public SALOME_Event
2819 {
2820 public:
2821   typedef QList<int> TResult;
2822   TResult myResult;
2823   QString myType;
2824   TFindViews( const QString& type )
2825     : myType( type ) {}
2826   virtual void Execute()
2827   {
2828     myResult.clear();
2829     LightApp_Application* app  = getApplication();
2830     if ( app ) {
2831       ViewManagerList vmList;
2832       app->viewManagers( myType, vmList );
2833       SUIT_ViewManager* viewMgr;
2834       foreach ( viewMgr, vmList ) {
2835         QVector<SUIT_ViewWindow*> vec = viewMgr->getViews();
2836         for ( int i = 0, n = vec.size(); i < n; i++ ) {
2837           SUIT_ViewWindow* wnd = vec[ i ];
2838           if ( wnd )
2839             {
2840               MESSAGE("SUIT_ViewWindow*: "<< wnd << " id: " << wnd->getId());
2841               myResult.append( wnd->getId() );
2842             }
2843         }
2844       }
2845     }
2846   }
2847 };
2848 QList<int> SalomePyQt::findViews( const QString& type )
2849 {
2850   return ProcessEvent( new TFindViews( type ) );
2851 }
2852
2853 /*!
2854   \fn bool SalomePyQt::activateView( const int id );
2855   \brief Activate view
2856   \param id window identifier
2857   \return \c true if operation is completed successfully and \c false otherwise
2858 */
2859
2860 class TActivateView: public SALOME_Event
2861 {
2862 public:
2863   typedef bool TResult;
2864   TResult myResult;
2865   int myWndId;
2866   TActivateView( const int id )
2867     : myResult( false ),
2868       myWndId( id ) {}
2869   virtual void Execute()
2870   {
2871     SUIT_ViewWindow* wnd = getWnd( myWndId );
2872     MESSAGE("window id:" << myWndId << " SUIT_ViewWindow*: " << wnd);
2873     if ( wnd ) {
2874       wnd->setFocus();
2875       myResult = true;
2876     }
2877   }
2878 };
2879 bool SalomePyQt::activateView( const int id )
2880 {
2881   return ProcessEvent( new TActivateView( id ) );
2882 }
2883
2884 /*!
2885  *
2886  */
2887
2888 class TActivateViewManagerAndView: public SALOME_Event
2889 {
2890 public:
2891   typedef bool TResult;
2892   TResult myResult;
2893   int myWndId;
2894   TActivateViewManagerAndView( const int id )
2895     : myResult( false ),
2896       myWndId( id ) {}
2897   virtual void Execute()
2898   {
2899     SUIT_ViewWindow* wnd = getWnd( myWndId );
2900     MESSAGE("window id:" << myWndId << " SUIT_ViewWindow*: " << wnd);
2901     if ( wnd )
2902       {
2903         LightApp_Application* app  = getApplication();
2904         app->setActiveViewManager(wnd->getViewManager());
2905         wnd->setFocus();
2906         myResult = true;
2907       }
2908   }
2909 };
2910 bool SalomePyQt::activateViewManagerAndView( const int id )
2911 {
2912   return ProcessEvent( new TActivateViewManagerAndView( id ) );
2913 }
2914
2915 /*!
2916  *
2917  */
2918
2919 class TGetViewWidget: public SALOME_Event
2920 {
2921 public:
2922   typedef QWidget* TResult;
2923   TResult myResult;
2924   int myWndId;
2925   TGetViewWidget( const int id )
2926     : myResult( 0 ),
2927       myWndId( id ) {}
2928   virtual void Execute()
2929   {
2930     SUIT_ViewWindow* wnd = getWnd( myWndId );
2931     if ( wnd ) {
2932         myResult = (QWidget*)wnd;
2933     }
2934   }
2935 };
2936 QWidget* SalomePyQt::getViewWidget( const int id)
2937 {
2938   return ProcessEvent( new TGetViewWidget( id ) );
2939 }
2940
2941
2942 /*!
2943   \fn int SalomePyQt::createView( const QString& type, bool visible = true, const int width = 0, const int height = 0 );
2944   \brief Create new view and activate it
2945   \param type viewer type
2946   \param visible
2947   \param width
2948   \param height
2949   \return integer identifier of created view (or -1 if view could not be created)
2950 */
2951
2952 class TCreateView: public SALOME_Event
2953 {
2954 public:
2955   typedef int TResult;
2956   TResult myResult;
2957   QString myType;
2958   bool myVisible;
2959   int myWidth;
2960   int myHeight;
2961   TCreateView( const QString& theType, bool visible, const int width, const int height )
2962     : myResult( -1 ),
2963       myType( theType ),
2964       myVisible(visible),
2965       myWidth(width),
2966       myHeight(height) {}
2967   virtual void Execute()
2968   {
2969     LightApp_Application* app  = getApplication();
2970     if ( app ) {
2971       SUIT_ViewManager* viewMgr = app->createViewManager( myType );
2972       if ( viewMgr ) {
2973         QWidget* wnd = viewMgr->getActiveView();
2974         myResult = viewMgr->getActiveView()->getId();
2975         if ( wnd ) {
2976           if ( !myVisible )
2977             wnd->setVisible(false);
2978           if ( !myVisible && myWidth == 0 && myHeight == 0 ) {
2979             myWidth = 1024;
2980             myHeight = 768;
2981           }
2982           if (myWidth > 0 && myHeight > 0) {
2983 #ifndef DISABLE_PLOT2DVIEWER
2984             Plot2d_ViewWindow* wnd2D = dynamic_cast<Plot2d_ViewWindow*>( wnd );
2985             if ( wnd2D ) wnd = wnd2D->getViewFrame();
2986 #endif // DISABLE_PLOT2DVIEWER
2987             wnd->setGeometry( 0, 0, myWidth, myHeight );
2988           }
2989         }
2990       }
2991     }
2992   }
2993 };
2994 int SalomePyQt::createView( const QString& type, bool visible, const int width, const int height )
2995 {
2996   int ret = ProcessEvent( new TCreateView( type, visible, width, height ) );
2997   QCoreApplication::processEvents();
2998   return ret;
2999 }
3000
3001 /*!
3002   \fn int SalomePyQt::createView( const QString& type, QWidget* w );
3003   \brief Create new view with custom widget embedded and activate it
3004   \param type viewer type
3005   \param w custom widget
3006   \return integer identifier of created view (or -1 if view could not be created)
3007 */
3008
3009 class TCreateViewWg: public SALOME_Event
3010 {
3011 public:
3012   typedef int TResult;
3013   TResult myResult;
3014   QString myType;
3015   QWidget* myWidget;
3016   TCreateViewWg( const QString& theType, QWidget* w )
3017     : myResult( -1 ),
3018       myType( theType ),
3019       myWidget( w ) {}
3020   virtual void Execute()
3021   {
3022     LightApp_Application* app  = getApplication();
3023     if ( app ) {
3024       SUIT_ViewManager* viewMgr = app->createViewManager( myType, myWidget );
3025       if ( viewMgr ) {
3026         SUIT_ViewWindow* wnd = viewMgr->getActiveView();
3027         if ( wnd )
3028           myResult = wnd->getId();
3029       }
3030     }
3031   }
3032 };
3033 int SalomePyQt::createView( const QString& type, QWidget* w )
3034 {
3035   int ret = ProcessEvent( new TCreateViewWg( type, w ) );
3036   QCoreApplication::processEvents();
3037   return ret;
3038 }
3039
3040 /*!
3041   \fn bool SalomePyQt::closeView( const int id );
3042   \brief Close view
3043   \param id window identifier
3044   \return \c true if operation is completed successfully and \c false otherwise
3045 */
3046
3047 class TCloseView: public SALOME_Event
3048 {
3049 public:
3050   typedef bool TResult;
3051   TResult myResult;
3052   int myWndId;
3053   TCloseView( const int id )
3054     : myResult( false ),
3055       myWndId( id ) {}
3056   virtual void Execute()
3057   {
3058     SUIT_ViewWindow* wnd = getWnd( myWndId );
3059     if ( wnd ) {
3060       SUIT_ViewManager* viewMgr = wnd->getViewManager();
3061       if ( viewMgr ) {
3062         wnd->close();
3063         myResult = true;
3064       }
3065     }
3066   }
3067 };
3068 bool SalomePyQt::closeView( const int id )
3069 {
3070   return ProcessEvent( new TCloseView( id ) );
3071 }
3072
3073 /*!
3074   \fn int SalomePyQt::cloneView( const int id );
3075   \brief Clone view (if this operation is supported for specified view type)
3076   \param id window identifier
3077   \return integer identifier of the cloned view or -1 or operation could not be performed
3078 */
3079
3080 class TCloneView: public SALOME_Event
3081 {
3082 public:
3083   typedef int TResult;
3084   TResult myResult;
3085   int myWndId;
3086   TCloneView( const int id )
3087     : myResult( -1 ),
3088       myWndId( id ) {}
3089   virtual void Execute()
3090   {
3091     SUIT_ViewWindow* wnd = getWnd( myWndId );
3092     if ( wnd ) {
3093       SUIT_ViewManager* viewMgr = wnd->getViewManager();
3094       if ( viewMgr ) {
3095 #ifndef DISABLE_OCCVIEWER
3096         if ( wnd->inherits( "OCCViewer_ViewWindow" ) ) {
3097           OCCViewer_ViewWindow* occView = (OCCViewer_ViewWindow*)( wnd );
3098           occView->onCloneView();
3099           wnd = viewMgr->getActiveView();
3100           if ( wnd )
3101             myResult = wnd->getId();
3102         }
3103 #endif // DISABLE_OCCVIEWER
3104 #ifndef DISABLE_PLOT2DVIEWER
3105         if ( wnd->inherits( "Plot2d_ViewWindow" ) ) {
3106           Plot2d_ViewManager* viewMgr2d = dynamic_cast<Plot2d_ViewManager*>( viewMgr );
3107           Plot2d_ViewWindow* srcWnd2d = dynamic_cast<Plot2d_ViewWindow*>( wnd );
3108           if ( viewMgr2d && srcWnd2d ) {
3109             Plot2d_ViewWindow* resWnd = viewMgr2d->cloneView( srcWnd2d );
3110             myResult = resWnd->getId();
3111           }
3112         }
3113 #endif // DISABLE_OCCVIEWER
3114       }
3115     }
3116   }
3117 };
3118 int SalomePyQt::cloneView( const int id )
3119 {
3120   return ProcessEvent( new TCloneView( id ) );
3121 }
3122
3123 /*!
3124   \fn bool SalomePyQt::setViewVisible( const int id, const bool visible )
3125   \brief Set view visibility.
3126   \param id window identifier
3127   \param visible new visiblity
3128 */
3129
3130 void SalomePyQt::setViewVisible( const int id, const bool visible )
3131 {
3132   class TEvent: public SALOME_Event
3133   {
3134     int myWndId;
3135     bool myVisible;
3136   public:
3137     TEvent( const int id, const bool visible )
3138       : myWndId( id ), myVisible( visible ) {}
3139     virtual void Execute()
3140     {
3141       SUIT_ViewWindow* wnd = getWnd( myWndId );
3142       if ( wnd ) wnd->setVisible( myVisible );
3143     }
3144   };
3145   ProcessVoidEvent( new TEvent( id, visible ) );
3146 }
3147
3148 /*!
3149   \fn bool SalomePyQt::isViewVisible( const int id );
3150   \brief Check whether view is visible ( i.e. it is on the top of the views stack)
3151   \param id window identifier
3152   \return \c true if view is visible and \c false otherwise
3153 */
3154
3155 class TIsViewVisible: public SALOME_Event
3156 {
3157 public:
3158   typedef bool TResult;
3159   TResult myResult;
3160   int myWndId;
3161   TIsViewVisible( const int id )
3162     : myResult( false ),
3163       myWndId( id ) {}
3164   virtual void Execute()
3165   {
3166     SUIT_ViewWindow* wnd = getWnd( myWndId );
3167     if ( wnd )
3168     {
3169       QWidget* p = wnd->parentWidget();
3170       myResult = ( p && p->isVisibleTo( p->parentWidget() ) );
3171     }
3172   }
3173 };
3174 bool SalomePyQt::isViewVisible( const int id )
3175 {
3176   return ProcessEvent( new TIsViewVisible( id ) );
3177 }
3178
3179 /*!
3180   \fn bool SalomePyQt::setViewClosable( const int id, const bool on );
3181   \brief Set / clear view's "closable" option. By default any view is closable
3182         (i.e. can be closed by the user).
3183   \param id window identifier
3184   \param on new "closable" option's value
3185 */
3186
3187 void SalomePyQt::setViewClosable( const int id, const bool on )
3188 {
3189   class TEvent: public SALOME_Event
3190   {
3191     int myWndId;
3192     bool myOn;
3193   public:
3194     TEvent( const int id, const bool on )
3195       : myWndId( id ), myOn( on ) {}
3196     virtual void Execute()
3197     {
3198       SUIT_ViewWindow* wnd = getWnd( myWndId );
3199       if ( wnd ) wnd->setClosable( myOn );
3200     }
3201   };
3202   ProcessVoidEvent( new TEvent( id, on ) );
3203 }
3204
3205 /*!
3206   \fn bool SalomePyQt::isViewClosable( const int id );
3207   \brief Check whether view is closable (i.e. can be closed by the user)
3208   \param id window identifier
3209   \return \c true if view is closable or \c false otherwise
3210 */
3211
3212 class TIsViewClosable: public SALOME_Event
3213 {
3214 public:
3215   typedef bool TResult;
3216   TResult myResult;
3217   int myWndId;
3218   TIsViewClosable( const int id )
3219     : myResult( true ),
3220       myWndId( id ) {}
3221   virtual void Execute()
3222   {
3223     SUIT_ViewWindow* wnd = getWnd( myWndId );
3224     if ( wnd )
3225       myResult = wnd->closable();
3226   }
3227 };
3228
3229 bool SalomePyQt::isViewClosable( const int id )
3230 {
3231   return ProcessEvent( new TIsViewClosable( id ) );
3232 }
3233
3234 /*!
3235   \fn bool SalomePyQt::groupAllViews();
3236   \brief Group all views to the single tab area
3237   \return \c true if operation is completed successfully and \c false otherwise
3238 */
3239
3240 class TGroupAllViews: public SALOME_Event
3241 {
3242 public:
3243   typedef bool TResult;
3244   TResult myResult;
3245   TGroupAllViews()
3246     : myResult( false ) {}
3247   virtual void Execute()
3248   {
3249     LightApp_Application* app  = getApplication();
3250     if ( app ) {
3251       STD_TabDesktop* tabDesk = dynamic_cast<STD_TabDesktop*>( app->desktop() );
3252       if ( tabDesk ) {
3253         QtxWorkstack* wStack = tabDesk->workstack();
3254         if ( wStack ) {
3255           wStack->stack();
3256           myResult = true;
3257         }
3258       }
3259     }
3260   }
3261 };
3262 bool SalomePyQt::groupAllViews()
3263 {
3264   return ProcessEvent( new TGroupAllViews() );
3265 }
3266
3267 /*!
3268   \fn bool SalomePyQt::splitView( const int id, const Orientation ori, const Action action );
3269   \brief Split tab area to which view with identifier belongs to
3270   \param id window identifier
3271   \param ori orientation of split operation
3272   \param action action to be performed
3273   \return \c true if operation is completed successfully \c false otherwise
3274 */
3275
3276 class TSplitView: public SALOME_Event
3277 {
3278 public:
3279   typedef bool TResult;
3280   TResult myResult;
3281   int myWndId;
3282   Orientation myOri;
3283   Action myAction;
3284   TSplitView( const int id,
3285               const Orientation ori,
3286               const Action action )
3287     : myResult( false ),
3288       myWndId( id ),
3289       myOri( ori ),
3290       myAction( action ) {}
3291   virtual void Execute()
3292   {
3293     SUIT_ViewWindow* wnd = getWnd( myWndId );
3294     if ( wnd ) {
3295       // activate view
3296       // wnd->setFocus(); ???
3297
3298       // split workstack
3299       if ( getApplication() ) {
3300         STD_TabDesktop* desk =
3301           dynamic_cast<STD_TabDesktop*>( getApplication()->desktop() );
3302         if ( desk ) {
3303           QtxWorkstack* wStack = desk->workstack();
3304           if ( wStack ) {
3305             Qt::Orientation qtOri =
3306               ( myOri == Horizontal ) ? Qt::Horizontal : Qt::Vertical;
3307
3308             QtxWorkstack::SplitType sType;
3309             if ( myAction == MoveWidget )
3310               sType = QtxWorkstack::SplitMove;
3311             else if ( myAction == LeaveWidget )
3312               sType = QtxWorkstack::SplitStay;
3313             else
3314               sType = QtxWorkstack::SplitAt;
3315
3316             wStack->Split( wnd, qtOri, sType );
3317             myResult = true;
3318           }
3319         }
3320       }
3321     }
3322   }
3323 };
3324 bool SalomePyQt::splitView( const int id, const Orientation ori, const Action action )
3325 {
3326   return ProcessEvent( new TSplitView( id, ori, action ) );
3327 }
3328
3329 /*!
3330   \fn bool SalomePyQt::moveView( const int id, const int id_to, const bool before );
3331   \brief Move view with the first identifier to the same area which
3332          another view with the second identifier belongs to
3333   \param id source window identifier
3334   \param id_to destination window identifier
3335   param before specifies whether the first viewt has to be moved before or after
3336         the second view
3337   \return \c true if operation is completed successfully and \c false otherwise
3338 */
3339
3340 class TMoveView: public SALOME_Event
3341 {
3342 public:
3343   typedef bool TResult;
3344   TResult myResult;
3345   int myWndId;
3346   int myWndToId;
3347   bool myIsBefore;
3348   TMoveView( const int id, const int id_to, const bool before )
3349     : myResult( false ),
3350     myWndId( id ),
3351     myWndToId( id_to ),
3352     myIsBefore( before ) {}
3353   virtual void Execute()
3354   {
3355     SUIT_ViewWindow* wnd = getWnd( myWndId );
3356     SUIT_ViewWindow* wnd_to = getWnd( myWndToId );
3357     if ( wnd && wnd_to ) {
3358       QtxWorkstack* wStack = dynamic_cast<STD_TabDesktop*>(
3359         getApplication()->desktop() )->workstack();
3360       if ( wStack )
3361         myResult = wStack->move( wnd, wnd_to, myIsBefore );
3362     }
3363   }
3364 };
3365 bool SalomePyQt::moveView( const int id, const int id_to, const bool before )
3366 {
3367   return ProcessEvent( new TMoveView( id, id_to, before ) );
3368 }
3369
3370 /*!
3371   \fn QList<int> SalomePyQt::neighbourViews( const int id );
3372   \brief Get list of views identifiers that belongs to the same area as
3373          specified view (excluding it)
3374   \param id window identifier
3375   \return list of views identifiers
3376 */
3377
3378 class TNeighbourViews: public SALOME_Event
3379 {
3380 public:
3381   typedef QList<int> TResult;
3382   TResult myResult;
3383   int myWndId;
3384   TNeighbourViews( const int id )
3385     : myWndId( id ) {}
3386   virtual void Execute()
3387   {
3388     myResult.clear();
3389     SUIT_ViewWindow* wnd = getWnd( myWndId );
3390     if ( wnd ) {
3391       QtxWorkstack* wStack = dynamic_cast<STD_TabDesktop*>(
3392         getApplication()->desktop() )->workstack();
3393       if ( wStack ) {
3394         QWidgetList wgList = wStack->windowList( wnd );
3395         QWidget* wg;
3396         foreach ( wg, wgList ) {
3397           SUIT_ViewWindow* tmpWnd = dynamic_cast<SUIT_ViewWindow*>( wg );
3398           if ( tmpWnd && tmpWnd != wnd )
3399             myResult.append( tmpWnd->getId() );
3400         }
3401       }
3402     }
3403   }
3404 };
3405 QList<int> SalomePyQt::neighbourViews( const int id )
3406 {
3407   return ProcessEvent( new TNeighbourViews( id ) );
3408 }
3409
3410
3411 /*!
3412   \fn void SalomePyQt::createRoot();
3413   \brief Initialize root data object.
3414
3415   Does nothing if root is already initialized.
3416 */
3417
3418 void SalomePyQt::createRoot()
3419 {
3420   class TEvent: public SALOME_Event
3421   {
3422   public:
3423     TEvent() {}
3424     virtual void Execute()
3425     {
3426       SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
3427       if ( module ) {
3428         SALOME_PYQT_DataModelLight* dm =
3429           dynamic_cast<SALOME_PYQT_DataModelLight*>( module->dataModel() );
3430         if ( dm )
3431           dm->getRoot();
3432       }
3433       else {
3434         if ( verbose() ) printf( "SalomePyQt.createRoot() function is not supported for the current module.\n" );
3435       }
3436     }
3437   };
3438   ProcessVoidEvent( new TEvent() );
3439 }
3440
3441 /*!
3442   \fn QString SalomePyQt::createObject( const QString& parent );
3443   \brief Create empty data object
3444   \param parent entry of parent data object
3445   \return entry of created data object
3446 */
3447
3448 class TCreateEmptyObjectEvent: public SALOME_Event
3449 {
3450 public:
3451   typedef QString TResult;
3452   TResult  myResult;
3453   QString  myParent;
3454   TCreateEmptyObjectEvent( const QString& parent )
3455     : myParent( parent ) {}
3456   virtual void Execute()
3457   {
3458     SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
3459     if ( module ) {
3460        myResult = module->createObject( myParent );
3461     }
3462     else {
3463       if ( verbose() ) printf( "SalomePyQt.createObject() function is not supported for the current module.\n" );
3464     }
3465   }
3466 };
3467 QString SalomePyQt::createObject( const QString& parent )
3468 {
3469   return ProcessEvent( new TCreateEmptyObjectEvent( parent ) );
3470 }
3471
3472 /*!
3473   \fn QString SalomePyQt::createObject( const QString& name, const QString& icon,
3474                                         const QString& tooltip,const QString& parent );
3475   \brief Create new data object with specified name, icon and tooltip
3476   \param name data object name
3477   \param icon data object icon
3478   \param toolTip data object tooltip
3479   \param parent entry of parent data object
3480   \return entry of created data object
3481 */
3482
3483 class TCreateObjectEvent: public SALOME_Event
3484 {
3485 public:
3486   typedef QString TResult;
3487   TResult myResult;
3488   QString myParent;
3489   QString myName;
3490   QString myIcon;
3491   QString myToolTip;
3492   TCreateObjectEvent( const QString& name,
3493                       const QString& icon,
3494                       const QString& tooltip,
3495                       const QString& parent )
3496     : myName( name ),
3497       myIcon( icon ),
3498       myToolTip( tooltip ),
3499       myParent( parent ) {}
3500   virtual void Execute()
3501   {
3502     SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
3503     if ( module ) {
3504       myResult = module->createObject( myName, myIcon, myToolTip, myParent );
3505     }
3506     else {
3507       if ( verbose() ) printf( "SalomePyQt.createObject() function is not supported for the current module.\n" );
3508     }
3509   }
3510 };
3511 QString SalomePyQt::createObject( const QString& name,
3512                                   const QString& icon,
3513                                   const QString& toolTip,
3514                                   const QString& parent )
3515 {
3516   return ProcessEvent( new TCreateObjectEvent( name, icon, toolTip, parent ) );
3517 }
3518
3519
3520 /*!
3521   \fn void SalomePyQt::setName( const QString& entry, const QString& name );
3522   \brief Set data object name
3523   \param entry data object entry
3524   \param name data object name
3525 */
3526 class TSetNameEvent: public SALOME_Event
3527 {
3528 public:
3529   QString myEntry;
3530   QString myName;
3531   TSetNameEvent( const QString& entry,
3532                  const QString& name )
3533   : myEntry( entry ),
3534     myName( name ) {}
3535   virtual void Execute()
3536   {
3537     SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
3538     if ( module ) {
3539       module->setName( myEntry, myName );
3540     }
3541     else {
3542       if ( verbose() ) printf( "SalomePyQt.setName() function is not supported for the current module.\n" );
3543     }
3544   }
3545 };
3546 void SalomePyQt::setName( const QString& entry, const QString& name )
3547 {
3548   ProcessVoidEvent( new TSetNameEvent( entry, name ) );
3549 }
3550
3551 /*!
3552   \fn void SalomePyQt::setIcon( const QString& entry, const QString& icon );
3553   \brief Set data object icon
3554   \param entry data object entry
3555   \param icon data object icon file name (icon is loaded from module resources)
3556 */
3557
3558 class TSetIconEvent: public SALOME_Event
3559 {
3560 public:
3561   QString myEntry;
3562   QString myIcon;
3563   TSetIconEvent( const QString& entry,
3564                  const QString& icon )
3565   : myEntry( entry ),
3566     myIcon( icon ) {}
3567   virtual void Execute()
3568   {
3569     SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
3570     if ( module ) {
3571       module->setIcon( myEntry, myIcon );
3572     }
3573     else {
3574       if ( verbose() ) printf( "SalomePyQt.setIcon() function is not supported for the current module.\n" );
3575     }
3576   }
3577 };
3578
3579 void SalomePyQt::setIcon( const QString& entry, const QString& icon )
3580 {
3581   ProcessVoidEvent( new TSetIconEvent( entry, icon ) );
3582 }
3583
3584 /*!
3585   \fn void SalomePyQt::setToolTip( const QString& entry, const QString& toolTip );
3586   \brief Set data object tooltip
3587   \param entry data object entry
3588   \param toolTip data object tooltip
3589 */
3590
3591 class TSetToolTipEvent: public SALOME_Event
3592 {
3593 public:
3594   QString myEntry;
3595   QString myToolTip;
3596   TSetToolTipEvent( const QString& entry,
3597                     const QString& toolTip )
3598     : myEntry( entry ),
3599       myToolTip( toolTip ) {}
3600   virtual void Execute()
3601   {
3602     SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
3603     if ( module ) {
3604       module->setToolTip( myEntry, myToolTip );
3605     }
3606     else {
3607       if ( verbose() ) printf( "SalomePyQt.setToolTip() function is not supported for the current module.\n" );
3608     }
3609   }
3610 };
3611 void SalomePyQt::setToolTip( const QString& entry, const QString& toolTip )
3612 {
3613   ProcessVoidEvent( new TSetToolTipEvent( entry, toolTip ) );
3614 }
3615
3616 /*!
3617   \fn void SalomePyQt::setReference( const QString& entry, const QString& refEntry );
3618   \brief Set reference to another data object
3619   \param entry data object entry
3620   \param refEntry referenced data object entry
3621 */
3622
3623 class TSetRefEvent: public SALOME_Event
3624 {
3625 public:
3626   QString myEntry;
3627   QString myRefEntry;
3628   TSetRefEvent( const QString& entry,
3629                 const QString& refEntry )
3630     : myEntry( entry ),
3631       myRefEntry( refEntry ) {}
3632   virtual void Execute()
3633   {
3634     SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
3635     if ( module ) {
3636       module->setReference( myEntry, myRefEntry );
3637     }
3638     else {
3639       if ( verbose() ) printf( "SalomePyQt.setReference() function is not supported for the current module.\n" );
3640     }
3641   }
3642 };
3643 void SalomePyQt::setReference( const QString& entry, const QString& refEntry )
3644 {
3645   ProcessVoidEvent( new TSetRefEvent( entry, refEntry ) );
3646 }
3647
3648 /*!
3649   \fn void SalomePyQt::setColor( const QString& entry, const QColor& color );
3650   \brief Set data object color
3651   \param entry data object entry
3652   \param color data object color
3653  */
3654
3655 class TSetColorEvent: public SALOME_Event
3656 {
3657 public:
3658   QString myEntry;
3659   QColor  myColor;
3660   TSetColorEvent( const QString& entry,
3661                   const QColor& color )
3662     : myEntry( entry ),
3663       myColor( color ) {}
3664   virtual void Execute()
3665   {
3666     SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
3667     if ( module ) {
3668       module->setColor( myEntry, myColor );
3669     }
3670     else {
3671       if ( verbose() ) printf( "SalomePyQt.setColor() function is not supported for the current module.\n" );
3672     }
3673   }
3674 };
3675 void SalomePyQt::setColor( const QString& entry, const QColor& color )
3676 {
3677   ProcessVoidEvent( new TSetColorEvent( entry, color ) );
3678 }
3679
3680 /*!
3681   \fn QString SalomePyQt::getName( const QString& entry );
3682   \brief Get data object name
3683   \param entry data object entry
3684   \return data object name
3685 */
3686
3687 class TGetNameEvent: public SALOME_Event
3688 {
3689 public:
3690   typedef QString TResult;
3691   TResult myResult;
3692   QString myEntry;
3693   TGetNameEvent( const QString& entry )
3694     : myEntry( entry ) {}
3695   virtual void Execute()
3696   {
3697     SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
3698     if ( module ) {
3699       myResult = module->getName( myEntry );
3700     }
3701     else {
3702       if ( verbose() ) printf( "SalomePyQt.getName() function is not supported for the current module.\n" );
3703     }
3704   }
3705 };
3706 QString SalomePyQt::getName( const QString& entry )
3707 {
3708   return ProcessEvent( new TGetNameEvent( entry ) );
3709 }
3710
3711 /*!
3712   \fn QString SalomePyQt::getToolTip( const QString& entry );
3713   \brief Get data object tooltip
3714   \param entry data object entry
3715   \return data object tooltip
3716 */
3717
3718 class TGetToolTipEvent: public SALOME_Event
3719 {
3720 public:
3721   typedef QString TResult;
3722   TResult myResult;
3723   QString myEntry;
3724   TGetToolTipEvent( const QString& entry )
3725   : myEntry( entry ) {}
3726   virtual void Execute()
3727   {
3728     SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
3729     if ( module ) {
3730       myResult = module->getToolTip( myEntry );
3731     }
3732     else {
3733       if ( verbose() ) printf( "SalomePyQt.getToolTip() function is not supported for the current module.\n" );
3734     }
3735   }
3736 };
3737 QString SalomePyQt::getToolTip( const QString& entry )
3738 {
3739   return ProcessEvent( new TGetToolTipEvent( entry ) );
3740 }
3741
3742 /*
3743   \fn QString SalomePyQt::getReference( const QString& entry );
3744   \brief Get entry of the referenced object (if there's any)
3745   \param entry data object entry
3746   \return referenced data object entry
3747 */
3748
3749 class TGetRefEvent: public SALOME_Event
3750 {
3751 public:
3752   typedef QString TResult;
3753   TResult myResult;
3754   QString myEntry;
3755   TGetRefEvent( const QString& entry )
3756   : myEntry( entry ) {}
3757   virtual void Execute()
3758   {
3759     SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
3760     if ( module ) {
3761       myResult = module->getReference( myEntry );
3762     }
3763     else {
3764       if ( verbose() ) printf( "SalomePyQt.getReference() function is not supported for the current module.\n" );
3765     }
3766   }
3767 };
3768 QString SalomePyQt::getReference( const QString& entry )
3769 {
3770   return ProcessEvent( new TGetRefEvent( entry ) );
3771 }
3772
3773 /*!
3774   \fn QColor SalomePyQt::getColor( const QString& entry );
3775   \brief Get data object color
3776   \param entry data object entry
3777   \return data object color
3778 */
3779
3780 class TGetColorEvent: public SALOME_Event
3781 {
3782 public:
3783   typedef QColor TResult;
3784   TResult myResult;
3785   QString myEntry;
3786   TGetColorEvent( const QString& entry )
3787   : myEntry( entry ) {}
3788   virtual void Execute()
3789   {
3790     SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
3791     if ( module ) {
3792       myResult = module->getColor( myEntry );
3793     }
3794     else {
3795       if ( verbose() ) printf( "SalomePyQt.getColor() function is not supported for the current module.\n" );
3796     }
3797   }
3798 };
3799 QColor SalomePyQt::getColor( const QString& entry )
3800 {
3801   return ProcessEvent( new TGetColorEvent( entry ) );
3802 }
3803
3804 /*!
3805   \fn void SalomePyQt::removeChildren( const QString& entry );
3806   \brief Remove all child data objects from specified data object
3807   \param entry data object entry
3808 */
3809
3810 class TRemoveChildEvent: public SALOME_Event
3811 {
3812 public:
3813   QString myEntry;
3814   TRemoveChildEvent( const QString& entry )
3815   : myEntry( entry ) {}
3816   virtual void Execute()
3817   {
3818     SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
3819     if ( module ) {
3820       module->removeChildren( myEntry );
3821     }
3822     else {
3823       if ( verbose() ) printf( "SalomePyQt.removeChildren() function is not supported for the current module.\n" );
3824     }
3825   }
3826 };
3827 void SalomePyQt::removeChildren( const QString& entry )
3828 {
3829   ProcessVoidEvent( new TRemoveChildEvent( entry ) );
3830 }
3831 void SalomePyQt::removeChild( const QString& entry )
3832 {
3833   if ( verbose() ) printf( "SalomePyQt.removeChild() function is obsolete. Use SalomePyQt.removeChildren() instead." );
3834   removeChildren( entry );
3835 }
3836
3837 /*!
3838   \fn void SalomePyQt::removeObject( const QString& entry );
3839   \brief Remove object by entry
3840   \param entry data object entry
3841 */
3842
3843 class TRemoveObjectEvent: public SALOME_Event
3844 {
3845 public:
3846   QString myEntry;
3847
3848   TRemoveObjectEvent( const QString& entry )
3849   : myEntry( entry ) {}
3850   virtual void Execute()
3851   {
3852     SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
3853     if ( module ) {
3854       module->removeObject( myEntry );
3855     }
3856     else {
3857       if ( verbose() ) printf( "SalomePyQt.removeObject() function is not supported for the current module.\n" );
3858     }
3859   }
3860 };
3861 void SalomePyQt::removeObject( const QString& entry )
3862 {
3863   ProcessVoidEvent( new TRemoveObjectEvent( entry ) );
3864 }
3865
3866 /*!
3867   \fn QStringList SalomePyQt::getChildren( const QString& entry, const bool recursive );
3868   \brief Get entries of all child data objects of specified data object
3869   \param entry data object entry
3870   \param recursive \c true for recursive processing
3871 */
3872
3873 class TGetChildrenEvent: public SALOME_Event
3874 {
3875 public:
3876   typedef QStringList TResult;
3877   TResult myResult;
3878   QString myEntry;
3879   bool    myRecursive;
3880   TGetChildrenEvent( const QString& entry, const bool recursive )
3881     : myEntry( entry ),
3882       myRecursive( recursive ) {}
3883   virtual void Execute()
3884   {
3885     SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
3886     if ( module ) {
3887       myResult = module->getChildren( myEntry, myRecursive );
3888     }
3889     else {
3890       if ( verbose() ) printf( "SalomePyQt.getChildren() function is not supported for the current module.\n" );
3891     }
3892   }
3893 };
3894 QStringList SalomePyQt::getChildren( const QString& entry, const bool recursive )
3895 {
3896   return ProcessEvent( new TGetChildrenEvent( entry, recursive ) );
3897 }
3898
3899 #ifndef DISABLE_PLOT2DVIEWER
3900 // Next set of methods relates to the Plot2d viewer functionality
3901
3902 /*!
3903   \fn void SalomePyQt::displayCurve( const int id, Plot2d_Curve* theCurve )
3904   \brief Display theCurve in view
3905   \param id window identifier
3906   \param theCurve curve to display
3907 */
3908
3909 class TDisplayCurve: public SALOME_Event
3910 {
3911 public:
3912   int myWndId;
3913   Plot2d_Curve* myCurve;
3914   TDisplayCurve( const int id, Plot2d_Curve* theCurve ) : myWndId( id ), myCurve( theCurve ) {}
3915   virtual void Execute() {
3916     Plot2d_ViewWindow* wnd = dynamic_cast<Plot2d_ViewWindow*>( getWnd( myWndId ) );
3917     if ( wnd )
3918       wnd->getViewFrame()->displayCurve( myCurve );
3919   }
3920 };
3921 void SalomePyQt::displayCurve( const int id, Plot2d_Curve* theCurve )
3922 {
3923   ProcessVoidEvent( new TDisplayCurve( id, theCurve ) );
3924 }
3925
3926 /*!
3927   \fn void SalomePyQt::eraseCurve( const int id, Plot2d_Curve* theCurve )
3928   \brief Erase theCurve in view
3929   \param id window identifier
3930   \param theCurve curve to erase
3931 */
3932
3933 class TEraseCurve: public SALOME_Event
3934 {
3935 public:
3936   int myWndId;
3937   Plot2d_Curve* myCurve;
3938   TEraseCurve( const int id, Plot2d_Curve* theCurve ) : myWndId( id ), myCurve( theCurve ) {}
3939   virtual void Execute() {
3940     Plot2d_ViewWindow* wnd = dynamic_cast<Plot2d_ViewWindow*>( getWnd( myWndId ) );
3941     wnd->getViewFrame()->eraseCurve( myCurve );
3942   }
3943 };
3944 void SalomePyQt::eraseCurve( const int id, Plot2d_Curve* theCurve )
3945 {
3946   ProcessVoidEvent( new TEraseCurve( id, theCurve ) );
3947 }
3948
3949 /*!
3950   \fn void SalomePyQt::deleteCurve( Plot2d_Curve* theCurve )
3951   \brief Delete theCurve from all views
3952   \param theCurve curve to delete
3953 */
3954
3955 class TDeleteCurve: public SALOME_Event
3956 {
3957 public:
3958   Plot2d_Curve* myCurve;
3959   TDeleteCurve( Plot2d_Curve* theCurve ) : myCurve( theCurve ) {}
3960   virtual void Execute() {
3961     LightApp_Application* app  = getApplication();
3962     if ( app ) {
3963       STD_TabDesktop* tabDesk = dynamic_cast<STD_TabDesktop*>( app->desktop() );
3964       if ( tabDesk ) {
3965         QList<SUIT_ViewWindow*> wndlist = tabDesk->windows();
3966         SUIT_ViewWindow* wnd;
3967         foreach ( wnd, wndlist ) {
3968           Plot2d_ViewWindow* aP2d = dynamic_cast<Plot2d_ViewWindow*>( wnd );
3969           if ( aP2d )
3970             aP2d->getViewFrame()->eraseObject( myCurve );
3971         }
3972       }
3973     }
3974   }
3975 };
3976 void SalomePyQt::eraseCurve( Plot2d_Curve* theCurve )
3977 {
3978   ProcessVoidEvent( new TDeleteCurve( theCurve ) );
3979 }
3980
3981 /*!
3982   \brief updateCurves (repaint) curves in view window.
3983 */
3984 void SalomePyQt::updateCurves( const int id )
3985 {
3986   class TEvent: public SALOME_Event
3987   {
3988   public:
3989     int myWndId;
3990     TEvent( const int id ) : myWndId( id ) {}
3991     virtual void Execute()
3992     {
3993       Plot2d_ViewWindow* wnd = dynamic_cast<Plot2d_ViewWindow*>( getWnd( myWndId ) );
3994       if ( wnd )
3995         wnd->getViewFrame()->DisplayAll();
3996     }
3997   };
3998   ProcessVoidEvent( new TEvent( id ) );
3999 }
4000
4001 /*!
4002   \fn QString SalomePyQt::getPlot2dTitle( const int id, ObjectType type = MainTitle )
4003   \brief Get title of corresponding type
4004   \param id window identifier
4005   \param type is type of title
4006   \return title of corresponding type
4007 */
4008
4009 class TGetPlot2dTitle: public SALOME_Event
4010 {
4011 public:
4012   typedef QString TResult;
4013   TResult myResult;
4014   int myWndId;
4015   ObjectType myType;
4016   TGetPlot2dTitle(const int id, ObjectType type) :
4017     myWndId( id ),
4018     myType( type ) {}
4019   virtual void Execute() {
4020     Plot2d_ViewWindow* wnd = dynamic_cast<Plot2d_ViewWindow*>( getWnd( myWndId ) );
4021     if ( wnd )
4022       myResult = wnd->getViewFrame()->getTitle( (Plot2d_ViewFrame::ObjectType)myType );
4023   }
4024 };
4025 QString SalomePyQt::getPlot2dTitle( const int id, ObjectType type )
4026 {
4027   return ProcessEvent( new TGetPlot2dTitle( id, type ) );
4028 }
4029
4030
4031 /*!
4032   \fn void SalomePyQt::setPlot2dTitle( const int id, const QString& title, ObjectType type = MainTitle, bool show = true )
4033   \brief Set title of corresponding type
4034   \param id window identifier
4035   \param title
4036   \param type is type of title
4037   \param show
4038 */
4039
4040 class TSetPlot2dTitle: public SALOME_Event
4041 {
4042 public:
4043   int myWndId;
4044   Plot2d_Curve* myCurve;
4045   QString myTitle;
4046   ObjectType myType;
4047   bool myShow;
4048   TSetPlot2dTitle( const int id, const QString& title, ObjectType type, bool show ) :
4049     myWndId( id ),
4050     myTitle( title ),
4051     myType( type ),
4052     myShow( show ) {}
4053   virtual void Execute() {
4054     Plot2d_ViewWindow* wnd = dynamic_cast<Plot2d_ViewWindow*>( getWnd( myWndId ) );
4055     wnd->getViewFrame()->setTitle( myShow, myTitle, (Plot2d_ViewFrame::ObjectType)myType, false );
4056   }
4057 };
4058 void SalomePyQt::setPlot2dTitle( const int id, const QString& title, ObjectType type, bool show )
4059 {
4060   ProcessVoidEvent( new TSetPlot2dTitle( id, title, type, show ) );
4061 }
4062
4063 /*!
4064   \fn QList<int> SalomePyQt::getPlot2dFitRangeByCurves( const int id )
4065   \brief Get list of Plot2d view ranges
4066   \param id window identifier
4067   \return list of view ranges (XMin, XMax, YMin, YMax)
4068 */
4069
4070 class TFitRangeByCurves: public SALOME_Event
4071 {
4072 public:
4073   typedef QList<double> TResult;
4074   TResult myResult;
4075   int myWndId;
4076   TFitRangeByCurves( const int id )
4077     : myWndId( id ) {}
4078   virtual void Execute()
4079   {
4080     myResult.clear();
4081     Plot2d_ViewWindow* wnd = dynamic_cast<Plot2d_ViewWindow*>( getWnd( myWndId ) );
4082     if ( wnd ) {
4083       double XMin, XMax, YMin, YMax, Y2Min, Y2Max;
4084       wnd->getViewFrame()->getFitRangeByCurves( XMin, XMax, YMin, YMax, Y2Min, Y2Max );
4085       myResult.append( XMin );
4086       myResult.append( XMax );
4087       myResult.append( YMin );
4088       myResult.append( YMax );
4089     }
4090   }
4091 };
4092 QList<double> SalomePyQt::getPlot2dFitRangeByCurves( const int id )
4093 {
4094   return ProcessEvent( new TFitRangeByCurves( id ) );
4095 }
4096
4097 /*!
4098   \fn QList<int> SalomePyQt::getPlot2dFitRangeCurrent( const int id )
4099   \brief Get list of current Plot2d view ranges
4100   \param id window identifier
4101   \return list of view ranges (XMin, XMax, YMin, YMax)
4102 */
4103
4104 class TFitRangeCurrent: public SALOME_Event
4105 {
4106 public:
4107   typedef QList<double> TResult;
4108   TResult myResult;
4109   int myWndId;
4110   TFitRangeCurrent( const int id )
4111     : myWndId( id ) {}
4112   virtual void Execute()
4113   {
4114     myResult.clear();
4115     Plot2d_ViewWindow* wnd = dynamic_cast<Plot2d_ViewWindow*>( getWnd( myWndId ) );
4116     if ( wnd ) {
4117       double XMin, XMax, YMin, YMax, Y2Min, Y2Max;
4118       wnd->getViewFrame()->getFitRanges( XMin, XMax, YMin, YMax, Y2Min, Y2Max );
4119       myResult.append( XMin );
4120       myResult.append( XMax );
4121       myResult.append( YMin );
4122       myResult.append( YMax );
4123     }
4124   }
4125 };
4126 QList<double> SalomePyQt::getPlot2dFitRangeCurrent( const int id )
4127 {
4128   return ProcessEvent( new TFitRangeCurrent( id ) );
4129 }
4130
4131 /*!
4132   \fn void SalomePyQt::setPlot2dFitRange( const int id, const double XMin, const double XMax, const double YMin, const double YMax )
4133   \brief Set range of Plot2d view
4134   \param id window identifier
4135   \param XMin
4136   \param XMax
4137   \param YMin
4138   \param YMax
4139 */
4140
4141 class TPlot2dFitRange: public SALOME_Event
4142 {
4143 public:
4144   int myWndId;
4145   double myXMin;
4146   double myXMax;
4147   double myYMin;
4148   double myYMax;
4149   TPlot2dFitRange( const int id, const double XMin, const double XMax, const double YMin, const double YMax ) :
4150     myWndId( id ),
4151     myXMin( XMin ),
4152     myXMax( XMax ),
4153     myYMin( YMin ),
4154     myYMax( YMax ) {}
4155   virtual void Execute() {
4156     Plot2d_ViewWindow* wnd = dynamic_cast<Plot2d_ViewWindow*>( getWnd( myWndId ) );
4157     if ( wnd )
4158       wnd->getViewFrame()->fitData( 0, myXMin, myXMax, myYMin, myYMax );
4159   }
4160 };
4161 void SalomePyQt::setPlot2dFitRange( const int id, const double XMin, const double XMax, const double YMin, const double YMax )
4162 {
4163   ProcessVoidEvent( new TPlot2dFitRange( id, XMin, XMax, YMin, YMax ) );
4164 }
4165
4166 // End of methods related to the Plot2d viewer functionality
4167 #endif // DISABLE_PLOT2DVIEWER
4168
4169 /*!
4170   \brief Process Qt event loop
4171 */
4172 void SalomePyQt::processEvents()
4173 {
4174   QCoreApplication::processEvents();
4175 }
4176
4177 /*!
4178   \brief Set visibility state for given object
4179   \param theEntry study ID of the object
4180   \param theState visibility state
4181 */
4182 void SalomePyQt::setVisibilityState( const QString& theEntry, VisibilityState theState )
4183 {
4184   class TEvent: public SALOME_Event
4185   {
4186     QString myEntry;
4187     int myState;
4188   public:
4189     TEvent( const QString& theEntry, int theState ):
4190       myEntry( theEntry ), myState( theState ) {}
4191     virtual void Execute()
4192     {
4193       LightApp_Study* aStudy = getActiveStudy();
4194       if ( !aStudy )
4195         return;
4196       aStudy->setVisibilityState( myEntry, (Qtx::VisibilityState)myState );
4197     }
4198   };
4199   ProcessVoidEvent( new TEvent( theEntry, theState ) );
4200 }
4201
4202 /*!
4203   \fn VisibilityState SalomePyQt::getVisibilityState( const QString& theEntry )
4204   \brief Get visibility state for given object
4205   \param theEntry study ID of the object
4206   \return visibility state
4207 */
4208
4209 class TGetVisibilityStateEvent: public SALOME_Event
4210 {
4211 public:
4212   typedef int TResult;
4213   TResult myResult;
4214   QString myEntry;
4215   TGetVisibilityStateEvent( const QString& theEntry ) : myResult( 0 ), myEntry( theEntry ) {}
4216   virtual void Execute()
4217   {
4218     LightApp_Study* aStudy = getActiveStudy();
4219     if ( aStudy )
4220       myResult = aStudy->visibilityState( myEntry );
4221   }
4222 };
4223 VisibilityState SalomePyQt::getVisibilityState( const QString& theEntry )
4224 {
4225   return (VisibilityState) ProcessEvent( new TGetVisibilityStateEvent( theEntry ) );
4226 }
4227
4228 /*!
4229   \brief Set position of given object in the tree
4230   \param theEntry study ID of the object
4231   \param thePos position
4232 */
4233 void SalomePyQt::setObjectPosition( const QString& theEntry, int thePos )
4234 {
4235   class TEvent: public SALOME_Event
4236   {
4237     QString myEntry;
4238     int myPos;
4239   public:
4240     TEvent( const QString& theEntry, int thePos ):
4241       myEntry( theEntry ), myPos( thePos ) {}
4242     virtual void Execute()
4243     {
4244       SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
4245       if ( module )
4246         module->setObjectPosition( myEntry, myPos );
4247     }
4248   };
4249   ProcessVoidEvent( new TEvent( theEntry, thePos ) );
4250 }
4251
4252 /*!
4253   \fn int SalomePyQt::getObjectPosition( const QString& theEntry )
4254   \brief Get position of given object in the tree
4255   \param theEntry study ID of the object
4256   \return position
4257 */
4258
4259 class TGetObjectPositionEvent: public SALOME_Event
4260 {
4261 public:
4262   typedef int TResult;
4263   TResult myResult;
4264   QString myEntry;
4265   TGetObjectPositionEvent( const QString& theEntry ) : myResult( 0 ), myEntry( theEntry ) {}
4266   virtual void Execute()
4267   {
4268     SALOME_PYQT_ModuleLight* module = dynamic_cast<SALOME_PYQT_ModuleLight*>( getActiveModule() );
4269     if ( module )
4270       myResult = module->getObjectPosition( myEntry );
4271   }
4272 };
4273 int SalomePyQt::getObjectPosition( const QString& theEntry )
4274 {
4275   return ProcessEvent( new TGetObjectPositionEvent( theEntry ) );
4276 }
4277
4278 /*!
4279   \brief Start recordind a log of Python commands from embedded console
4280   \param theFileName output lof file name
4281 */
4282 void SalomePyQt::startPyLog( const QString& theFileName )
4283 {
4284   class TEvent: public SALOME_Event
4285   {
4286     QString myFileName;
4287   public:
4288     TEvent( const QString& theFileName ):
4289       myFileName( theFileName ) {}
4290     virtual void Execute()
4291     {
4292       if ( getApplication() ) {
4293         PyConsole_Console* pyConsole = getApplication()->pythonConsole( false );
4294         if ( pyConsole ) pyConsole->startLog( myFileName );
4295       }
4296     }
4297   };
4298   ProcessVoidEvent( new TEvent( theFileName ) );
4299 }
4300
4301 /*!
4302   \brief Stop recordind a log of Python commands from embedded console
4303 */
4304 void SalomePyQt::stopPyLog()
4305 {
4306   class TEvent: public SALOME_Event
4307   {
4308   public:
4309     TEvent() {}
4310     virtual void Execute()
4311     {
4312       if ( getApplication() ) {
4313         PyConsole_Console* pyConsole = getApplication()->pythonConsole( false );
4314         if ( pyConsole ) pyConsole->stopLog();
4315       }
4316     }
4317   };
4318   ProcessVoidEvent( new TEvent() );
4319 }