]> Creatis software - bbtk.git/blobdiff - kernel/src/bbtkKWBlackBox.h
#3174 BBTK Bug New Normal - boost in fedore 26
[bbtk.git] / kernel / src / bbtkKWBlackBox.h
index 754a7dd5fe2ef2d89e89537112f6248539e157ce..d654f9aee711328d2edaf7c722a919e3b7def149 100644 (file)
@@ -1,33 +1,40 @@
-/*=========================================================================                                                                               
+/*
+ # ---------------------------------------------------------------------
+ #
+ # Copyright (c) CREATIS (Centre de Recherche en Acquisition et Traitement de l'Image
+ #                        pour la SantÈ)
+ # Authors : Eduardo Davila, Frederic Cervenansky, Claire Mouton
+ # Previous Authors : Laurent Guigues, Jean-Pierre Roux
+ # CreaTools website : www.creatis.insa-lyon.fr/site/fr/creatools_accueil
+ #
+ #  This software is governed by the CeCILL-B license under French law and
+ #  abiding by the rules of distribution of free software. You can  use,
+ #  modify and/ or redistribute the software under the terms of the CeCILL-B
+ #  license as circulated by CEA, CNRS and INRIA at the following URL
+ #  http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.html
+ #  or in the file LICENSE.txt.
+ #
+ #  As a counterpart to the access to the source code and  rights to copy,
+ #  modify and redistribute granted by the license, users are provided only
+ #  with a limited warranty  and the software's author,  the holder of the
+ #  economic rights,  and the successive licensors  have only  limited
+ #  liability.
+ #
+ #  The fact that you are presently reading this means that you have had
+ #  knowledge of the CeCILL-B license and that you accept its terms.
+ # ------------------------------------------------------------------------ */
+
+
+/*=========================================================================
   Program:   bbtk
   Module:    $RCSfile: bbtkKWBlackBox.h,v $
   Language:  C++
-  Date:      $Date: 2008/12/02 13:37:54 $
-  Version:   $Revision: 1.3 $
+  Date:      $Date: 2012/11/16 08:49:01 $
+  Version:   $Revision: 1.7 $
 ========================================================================*/
 
 
-/* ---------------------------------------------------------------------
-
-* Copyright (c) CREATIS-LRMN (Centre de Recherche en Imagerie Medicale)
-* Authors : Eduardo Davila, Laurent Guigues, Jean-Pierre Roux
-*
-*  This software is governed by the CeCILL-B license under French law and 
-*  abiding by the rules of distribution of free software. You can  use, 
-*  modify and/ or redistribute the software under the terms of the CeCILL-B 
-*  license as circulated by CEA, CNRS and INRIA at the following URL 
-*  http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.html 
-*  or in the file LICENSE.txt.
-*
-*  As a counterpart to the access to the source code and  rights to copy,
-*  modify and redistribute granted by the license, users are provided only
-*  with a limited warranty  and the software's author,  the holder of the
-*  economic rights,  and the successive licensors  have only  limited
-*  liability. 
-*
-*  The fact that you are presently reading this means that you have had
-*  knowledge of the CeCILL-B license and that you accept its terms.
-* ------------------------------------------------------------------------ */                                                                         
+
 /**
  * \brief Short description in one line
  * 
 
 #ifdef USE_KWWIDGETS
 
-#include "bbtkAtomicBlackBox.h"
+#include "bbtkWidgetBlackBox.h"
 
 
 #include "bbtkKW.h"
 
 
-//==================================================================
-// Forward declaration of the class of window associated to a KWBlackBox
-class vtkKWBlackBoxWindow;
-class vtkKWBlackBoxDialog;
-class vtkKWFrame;
-//==================================================================
-
 
 namespace bbtk
 {
 
 
 
-
-  //==================================================================
-  // Forward declaration of the widget event handler class
-  //  class KWBlackBoxWidgetEventHandler;
-  //==================================================================
-
-
   //==================================================================
   /// Widget black boxes
-  class BBTK_EXPORT KWBlackBox : public bbtk::AtomicBlackBox  
+  class BBTK_EXPORT KWBlackBox : public bbtk::WidgetBlackBox<vtkKWWidget>
   { 
-    BBTK_BLACK_BOX_INTERFACE(KWBlackBox,bbtk::AtomicBlackBox);
-    BBTK_DECLARE_INPUT(WinTitle,std::string);
-    BBTK_DECLARE_INPUT(WinWidth,int);
-    BBTK_DECLARE_INPUT(WinHeight,int);
-    BBTK_DECLARE_INPUT(WinDialog,bool);
-    BBTK_DECLARE_INPUT(WinHide,Void);
-    BBTK_DECLARE_INPUT(WinClose,Void);
-    BBTK_DECLARE_OUTPUT(Widget, vtkKWWidget*);
-
+    BBTK_BLACK_BOX_INTERFACE(KWBlackBox,bbtk::WidgetBlackBox<vtkKWWidget>);
   public:
-    /// Main processing method of the box. Overloaded to handle windows inclusion : if the output Widget is connected then the execution is transfered to the box to which it is connected (as the container window must be created and displayed - this box will be executed by the normal pipeline recursion mechanism)
-    virtual void bbExecute(bool force = false);
-
-
-    typedef vtkKWBlackBoxDialog Window;
-    
-    /// Returns the **OWN** window associated to the box
-    /// If 0 returned = no window
-    Window* bbGetWindow() { return bbmWindow; }
-
-    /// Returns the window containing the widget associated to the box
-    /// Which can be the own window of **ANOTHER** box in case of 
-    /// a hierarchy of widgets.
-    /// More precisely :
-    /// If bbGetWindow() != 0 then returns bbGetWindow()
-    /// Else if the output 'Widget' is connected 
-    ///  then returns bbGetContainingWindow() of the box connected to 'Widget'
-    /// Else returns 0;
-    Window* bbGetContainingWindow();
-
-    /// Returns the parent wxWindow that must be used to create the widget 
-         //
-         // LG 24/11/08 : New widget pipeline
-         //    wxWindow* bbGetKWParent();
-
-    /// Returns true iff the 'containing window' exists and is shown 
-    /// (see bbGetContainingWindow).
-    bool bbIsShown();
-
-    //==================================================================    
-    /// User callback invoked when the containing window is shown
-    virtual void bbUserOnShow() {}
-    //==================================================================    
-    //==================================================================    
-    /// User callback invoked when the containing window is hidden
-    virtual void bbUserOnHide() {}
-    //==================================================================    
-
-    // LG 24/11/08 : New widget pipeline
-    //    void bbCreateWidgetAndEventHandler(vtkKWWidget* parent); 
-  /// Sets the window
-    inline void bbSetWindow(Window* w) { bbmWindow=w; }
-
-         
-  protected:
-    
-  
-    //==================================================================
-    /// User callback called in the box contructor
-    virtual void bbUserConstructor();
-    /// User callback called in the box copy constructor
-    virtual void bbUserCopyConstructor(bbtk::BlackBox::Pointer);
-    /// User callback called in the box destructor
-    virtual void bbUserDestructor();
+   //==================================================================    
+    /// Callback for creating a Dialog window (modal)
+    virtual void bbCreateDialogWindow();
     //==================================================================    
 
     //==================================================================    
-    /// User callback for creating the widget associated to the box
-    /// ** Must be defined **
-    // LG 24/11/08 : New widget pipeline
-    virtual void bbUserCreateWidget(vtkKWFrame* parent) 
-    {
-      bbtkError(bbGetTypeName()<<" is a KWBlackBox whose bbUserCreateWidget methods is not overloaded : is it a feature or a bug ?!?");
-    }
+    /// Callback for creating a Frame window 
+    virtual void bbCreateFrameWindow();
     //==================================================================    
 
-
-    vtkKWWidget* bbCreateWidgetOfInput(const std::string& in, 
-                                      vtkKWFrame* parent);
-
-
     //==================================================================
-    /// Main processing method of the box.
-    virtual IOStatus bbBackwardUpdate( Connection::Pointer caller );
+    //    virtual void InitWindowManagerIfNeeded();
+    virtual void IncNbWindowsAlive();
+    virtual void DecNbWindowsAlive();
+    virtual int  GetNbWindowsAlive();
+    virtual bool IsSomeWindowAlive();
+    
+    virtual void IncNbWindowsShown();
+    virtual void DecNbWindowsShown();
+    virtual int  GetNbWindowsShown();
+    virtual bool IsSomeWindowShown();
     //==================================================================
 
 
-
-    //==================================================================
-    /// Overloaded processing method for KWBlackBoxes
-    virtual void bbProcess();
-    //==================================================================
-
     //==================================================================
-    /// If necessary creates the KWBlackBoxWindow associated to the box
-    /// and shows it 
-    /// (does nothing if the box output 'Widget' is connected which 
-    /// means that the box does not have its own window but is contained 
-    /// into another window)
-    void bbShowWindow();
-    /// Hides the KWBlackBoxWindow associated to the box (if exists)
-    void bbHideWindow();
-    /// Closes (destroys) the KWBlackBoxWindow associated to the box (if exists)
-    void bbCloseWindow();
+    vtkKWWidget* bbCreateWidgetOfInput(const std::string& in, 
+                                      vtkKWFrame* parent);
     //==================================================================
 
-  private:
-    /// friendship
-    friend class vtkKWBlackBoxWindow;
-    //    friend class KWBlackBoxWidgetEventHandler;
-
-  
-    /*
-    /// Sets the Widget Event Handler
-    inline void bbSetWidgetEventHandler(KWBlackBoxWidgetEventHandler* w) 
-    { bbmWidgetEventHandler = w; }
-    /// Gets the Widget Event Handler
-    inline KWBlackBoxWidgetEventHandler* bbGetWidgetEventHandler()
-    { return bbmWidgetEventHandler; }
-    */
-
-    /// The KWBlackBoxWindow associated to the box
-    Window* bbmWindow;
-    /// The KWBlackBoxWidgetEventHandler associated to the box
-    //    KWBlackBoxWidgetEventHandler* bbmWidgetEventHandler;
-
-
-    void bbInitAttributes();
-
-  protected :
-
-
-    /// For Forward update mechanism when execution is called 
-    /// on a contained window
-    /// Is set to true before transfering update to parent 
-    /// in order to not re-transfer a second time...
-    bool bbmUpdateTransferedToParent;
-
-    bool bbGetUpdateTransferedToParent() const { return bbmUpdateTransferedToParent; }
-    void bbSetUpdateTransferedToParent(bool b) 
-    { bbmUpdateTransferedToParent = b; }
 
   };
   //=================================================================
  
 
-  //======================================================================
-  /// Defines the bbUserCreateWidget method
-#define BBTK_CREATE_KWWIDGET(CALLBACK)                                 \
-  public:                                                              \
-  inline void bbUserCreateWidget(vtkKWFrame* parent)                   \
-  {                                                                    \
-    bbtkDebugMessageInc("kw",1,"**> Creating widget for ["             \
-                       <<bbGetFullName()<<"]"<<std::endl);             \
-    CALLBACK(parent);                                                  \
-    bbtkDebugMessageInc("kw",1,"<** Creating widget for ["             \
-                       <<bbGetFullName()<<"]"<<std::endl);             \
-  }
-  
-  //======================================================================
-
-  //======================================================================
-  /// Defines the bbUserOnShow method
-#define BBTK_ON_SHOW_WIDGET(CALLBACK)                                  \
-  public:                                                              \
-  inline void bbUserOnShow()                                   \
-  {                                                                    \
-    bbtkDebugMessageInc("wx",1,"**> Showing ["         \
-                       <<bbGetFullName()<<"]"<<std::endl);             \
-    CALLBACK();                                                                \
-    bbtkDebugMessageInc("wx",1,"<** Showing ["         \
-                       <<bbGetFullName()<<"]"<<std::endl);             \
-  }
-  
-  //======================================================================
-
   //=================================================================
   // KWBlackBoxDescriptor declaration
-  BBTK_BEGIN_DESCRIBE_BLACK_BOX(KWBlackBox,bbtk::AtomicBlackBox);
+  class KWBlackBoxDescriptor : public WidgetBlackBoxDescriptor<vtkKWWidget>
+  BBTK_BEGIN_DESCRIBE_BLACK_BOX_BODY(KWBlackBox);
   BBTK_NAME("KWBlackBox");
-  // BBTK_DESCRIPTION("Widget box. The inputs marked with (*) are only used if the widget is not inserted in another widget.\n");
-  BBTK_CATEGORY("widget");
-  BBTK_INPUT(KWBlackBox,WinTitle,
-            "Title of the window (*)",
-            std::string,"");
-  BBTK_INPUT(KWBlackBox,WinWidth,
-            "Width of the window (* : only used if the widget is not connected to a Layout box)",int,"");
-  BBTK_INPUT(KWBlackBox,WinHeight,
-            "Height of the window (*)",int,"");
-  BBTK_INPUT(KWBlackBox,WinDialog,
-            "Set to 'true' to create a dialog window, i.e. which blocks the pipeline until it is closed (modal) (*)",bool,"");
-  BBTK_INPUT(KWBlackBox,WinHide,
-            "Any signal received hides the window (*)",Void,"signal");
-  BBTK_INPUT(KWBlackBox,WinClose,
-            "Any signal received closes the window (*)",Void,"signal");
-  BBTK_OUTPUT(KWBlackBox,Widget,"Output widget",vtkKWWidget*,"");
   BBTK_END_DESCRIBE_BLACK_BOX(KWBlackBox);
   //=================================================================
 
@@ -285,34 +123,6 @@ namespace bbtk
 
 
 
-  /*
-  //=================================================================
-  // Handles the destroy events of a widget associated to a KWBlackBox 
-  // in order to signal the widget death to its associated box
-  class BBTK_EXPORT KWBlackBoxWidgetEventHandler : public wxEvtHandler
-  {
-  public:
-    /// Ctor with the box and widget 
-    KWBlackBoxWidgetEventHandler( KWBlackBox::Pointer box, wxWindow *widget );
-    /// Dtor
-    ~KWBlackBoxWidgetEventHandler();
-    /// Returns true iff is the handler for that window  
-    bool IsHandlerOf( wxWindow* w ) { return mWindow == w; }
-    // wxWindow* GetKWWindow() { return mWindow; }
-    /// Method processing the destroy event of the widget
-    void OnWindowDestroy(wxWindowDestroyEvent&);
-    //
-    //bool IsDead() { return mDead; }
-
-  private:
-    KWBlackBox::WeakPointer mBox;
-    wxWindow* mWindow;
-    //bool mDead;
-  };  
-  //=================================================================
-  */
-
-
 } //namespace bbtk