src/DSC/DSC_Basic/DSC_Callbacks.hxx

   1 //  Copyright (C) 2007-2008  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.
  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 //  File   : DSC_Callbacks.hxx
  23 //  Author : André RIBES (EDF)
  24 //  Module : KERNEL
  25 //
  26 #ifndef _DSC_CALLBACKS_HXX_
  27 #define _DSC_CALLBACKS_HXX_
  28
  29 #include "DSC_Basic.hxx"
  30
  31 #include <SALOMEconfig.h>
  32 #include CORBA_SERVER_HEADER(DSC_Engines)
  33
  34 /*! \class DSC_Callbacks
  35  *  \brief This is an abstract class that defines methods that the component
  36  *  uses to notify the component user code that the state of the component has changed.
  37  *
  38  *  Currently only port's connection modifications are signaled.
  39  */
  40 class DSC_BASIC_EXPORT DSC_Callbacks
  41 {
  42   public:
  43     DSC_Callbacks() {}
  44     virtual ~DSC_Callbacks() {}
  45
  46     /*! \brief This method is used by the component when the number of connection
  47      * on a provides port changes.
  48      *
  49      * This information helps the user code to detect operation on its ports.
  50      *
  51      * \param provides_port_name the name of the provides name that has changed.
  52      * \param connection_nbr the new number of connection on the provides port.
  53      * \param message contains informations about the modification of the port.
  54      */
  55     virtual void provides_port_changed(const char* provides_port_name,
  56                                        int connection_nbr,
  57                                        const Engines::DSC::Message message) = 0;
  58
  59     /*! \brief  This method is used by the component when the number of connection
  60      * on a uses port changes.
  61      *
  62      * This information helps the user code to detect operation on its ports.
  63      *
  64      * \param uses_port_name the name of the uses name that has changed.
  65      * \param new_uses_port the new sequence representing the uses port.
  66      * \param message contains informations about the modification of the port.
  67      */
  68     virtual void uses_port_changed(const char* uses_port_name,
  69                                    Engines::DSC::uses_port * new_uses_port,
  70                                    const Engines::DSC::Message message) = 0;
  71 };
  72
  73 #endif