-// Copyright (C) 2007-2008 CEA/DEN, EDF R&D, OPEN CASCADE
+// Copyright (C) 2007-2010 CEA/DEN, EDF R&D, OPEN CASCADE
//
// Copyright (C) 2003-2007 OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
// CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
//
// File : SALOME_Session.idl
// Author : Paul RASCLE, EDF
-// $Header$
-//
+
#include "SALOME_Component.idl"
-/*!
- This package contains interfaces used for management of the session in %SALOME application.
-*/
+/*! \file SALOME_Session.idl \brief file that contains interface of the session
+ */
+
module SALOME
{
/*! \brief State of the session
-
+
This enumeration contains values defining the state of the session
-
-*/
- enum SessionState {asleep, /*! Session is inactive */
- running /*! Session is running */
+
+*/
+ enum SessionState {asleep, /*!< Session is inactive */
+ running /*!< Session is running */
} ;
/*! \brief %Session State and Statistics
-
- This struct contains a field list with general information about the session
+ This struct contains a field list with general information about the session
*/
-
+
struct StatSession
{
/*! \brief State of the session
-
+
It can be:
- * -# asleep : no running study
- * -# running : one or more running studies
-*/
- SessionState state ;
-/*! Number of running studies
+ -# asleep : no running study
+ -# running : one or more running studies
*/
+ SessionState state ;
+ //! Number of running studies
short runningStudies ;
-/*! It is True if GUI is active in the session
-*/
+ //! It is True if GUI is active in the session
boolean activeGUI ;
} ;
+
/*! \brief Interface of the session
The %session Server launches and stops GUI (Graphical User Interface).
interface Session
{
-/*!
- This exception is raised when trying to stop the %session with active GUI
-*/
+//! This exception is raised when trying to stop the %session with active GUI
exception GUIActive {} ;
-/*!
- This exception is raised when trying to stop the %session with a number of running studies.
-*/
- exception RunningStudies {} ;
+//! This exception is raised when trying to stop the %session with a number of running studies.
+ exception RunningStudies {} ;
-/*!
- Launches GUI in the session
-*/
- void GetInterface();
+//! Launches GUI in the session
+ void GetInterface();
-/*!
- Returns a standalone component
-*/
- Engines::Component GetComponent(in string theLibraryName);
+//! Returns a standalone component
+ Engines::EngineComponent GetComponent(in string theLibraryName);
-/*!
- Stops the %Session (It must be idle)
-*/
+//! Stops the %Session (It must be idle)
void StopSession() raises(GUIActive, RunningStudies) ;
-/*!
- Gets Session State
-*/
+//! Gets Session State
StatSession GetStatSession() ;
-/*!
- Determines whether the server has already been loaded or not.
-*/
+
+//! Determines whether the server has already been loaded or not.
void ping();
-/*!
- Returns the PID of the server
-*/
+//! Returns the PID of the server
long getPID();
-/*!
- Get Active study ID
-*/
+//! Returns host name
+ string getHostname();
+//! Get Active study ID
long GetActiveStudyId();
-/*!
- Restores a state of the study at theSavePoint
-*/
+//! Restores a state of the study at theSavePoint
boolean restoreVisualState(in long theSavePoint);
+
+ //! Send a message to the session GUI desktop that will emit a qt signal
/*!
- Emit a qt signal from the session GUI desktop window.
This method can be used to send a message to the GUI from the standalone
container.
Caution: this method can block the Session and the calling container
In such a case it is recommended to use oneway method.
*/
void emitMessage(in string theMessage);
+
+ //! same as emitMessage but in a non blocking way
/*!
Emit a qt signal from the session GUI desktop window.
This method can be used to send a message to the GUI from the standalone