]> Creatis software - bbtk.git/blobdiff - kernel/src/bbtkWxBlackBox.h
*** empty log message ***
[bbtk.git] / kernel / src / bbtkWxBlackBox.h
index d259a874be3b584c15bbea4c7a5dd3f5f34ee57f..7c9db44300ea4d3e09786e367db368c8625c3c43 100644 (file)
@@ -1,20 +1,34 @@
-/*=========================================================================
-                                                                                
+/*=========================================================================                                                                               
   Program:   bbtk
   Module:    $RCSfile: bbtkWxBlackBox.h,v $
   Language:  C++
-  Date:      $Date: 2008/04/08 06:59:30 $
-  Version:   $Revision: 1.10 $
-                                                                                
-  Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
-  l'Image). All rights reserved. See Doc/License.txt or
-  http://www.creatis.insa-lyon.fr/Public/bbtk/License.html for details.
-                                                                                
-     This software is distributed WITHOUT ANY WARRANTY; without even
-     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
-     PURPOSE.  See the above copyright notices for more information.
-                                                                                
-=========================================================================*//**
+  Date:      $Date: 2009/05/14 14:43:34 $
+  Version:   $Revision: 1.27 $
+========================================================================*/
+
+
+/* ---------------------------------------------------------------------
+
+* 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
  * 
  * Long description which 
@@ -30,7 +44,7 @@
  */
 
 
-#ifdef _USE_WXWIDGETS_
+#ifdef USE_WXWIDGETS
 
 
 #ifndef __bbtkWxBlackBox_h__
@@ -38,7 +52,7 @@
 
 
 #include "bbtkWx.h"
-#include "bbtkAtomicBlackBox.h"
+#include "bbtkWidgetBlackBox.h"
 
 
 namespace bbtk
@@ -47,10 +61,6 @@ namespace bbtk
 
 
 
-  //==================================================================
-  // Forward declaration of the class of window associated to a WxBlackBox
-  class WxBlackBoxWindow;
-  //==================================================================
 
   //==================================================================
   // Forward declaration of the widget event handler class
@@ -60,167 +70,72 @@ namespace bbtk
 
   //==================================================================
   /// Widget black boxes
-  class BBTK_EXPORT WxBlackBox : public bbtk::AtomicBlackBox  
-  {
-    BBTK_USER_BLACK_BOX_INTERFACE(WxBlackBox,bbtk::AtomicBlackBox);
-    //   BBTK_DECLARE_INPUT(WinParent,WxParentToChildData*);
-    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_OUTPUT(Widget, wxWindow*);//WxBlackBoxWidget*);
-
+  class BBTK_EXPORT WxBlackBox : public bbtk::WidgetBlackBox<wxWindow>
+  { 
   public:
-    typedef WxBlackBoxWindow 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 
-    wxWindow* bbGetWxParent();
-
-    /// 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() {}
-    //==================================================================    
+    BBTK_BLACK_BOX_INTERFACE(WxBlackBox,bbtk::WidgetBlackBox<wxWindow>);
 
-  protected:
+         
+    //  protected:
     
+  public:
   
-    //==================================================================
-    /// User callback called in the box contructor
-    virtual void bbUserConstructor();
-    /// User callback called in the box copy constructor
-    virtual void bbUserCopyConstructor();
-    /// User callback called in the box destructor
-    virtual void bbUserDestructor();
+   //==================================================================    
+    /// Callback for creating a Dialog window (modal)
+    /// ** Must be defined ** in toolkit specific descendants 
+    virtual void bbCreateDialogWindow();
     //==================================================================    
 
     //==================================================================    
-    /// User callback for creating the widget associated to the box
-    /// ** Must be defined **
-    virtual void bbUserCreateWidget() 
-    {
-      bbtkError(bbGetTypeName()<<" is a WxBlackBox whose bbUserCreateWidget methods is not overloaded : is it a feature or a bug ?!?");
-    }
+    /// Callback for creating a Frame window 
+    /// ** Must be defined ** in toolkit specific descendants 
+    virtual void bbCreateFrameWindow();
     //==================================================================    
 
-
-    
-
+  
+  
     //==================================================================
-    /// Main processing method of the box.
-    virtual IOStatus bbBackwardUpdate( Connection* 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 WxBlackBoxes :
-    /// 1) if the widget is null then 
-    ///    calls the user defined widget creation method : bbUserCreateWidget()
-    /// 2) calls the user defined processing method : bbUserProcess()
-    /// 3) displays the window : bbShowWindow();
-    virtual void bbProcess();
-    //==================================================================
-
-    //==================================================================
-    /// If necessary creates the WxBlackBoxWindow 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 WxBlackBoxWindow associated to the box (if exists)
-    void bbHideWindow();
-    //==================================================================
+         
+    //==================================================================    
+    void bbCreateWidgetAndEventHandler(wxWindow* parent); 
+    //==================================================================    
+    
+    //==================================================================    
 
   private:
     /// friendship
-    friend class WxBlackBoxWindow;
     friend class WxBlackBoxWidgetEventHandler;
-
-    /// Sets the window
-    inline void bbSetWindow(Window* w) { bbmWindow=w; }
-
     /// Sets the Widget Event Handler
     inline void bbSetWidgetEventHandler(WxBlackBoxWidgetEventHandler* w) 
     { bbmWidgetEventHandler = w; }
     /// Gets the Widget Event Handler
     inline WxBlackBoxWidgetEventHandler* bbGetWidgetEventHandler()
     { return bbmWidgetEventHandler; }
-
-
-    /// The WxBlackBoxWindow associated to the box
-    Window* bbmWindow;
     /// The WxBlackBoxWidgetEventHandler associated to the box
     WxBlackBoxWidgetEventHandler* bbmWidgetEventHandler;
-
-
-    void bbInitAttributes();
-
-  protected :
-    /// 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 (the container window must be created and displayed - this box will be also executed by the normal pipeline recursion mechanism)
-    virtual void bbExecute(bool force = false);
-
   };
   //=================================================================
  
 
-  //======================================================================
-  /// Defines the bbUserCreateWidget method
-#define BBTK_CREATE_WIDGET(CALLBACK)                                   \
-  public:                                                              \
-  inline void bbUserCreateWidget()                                     \
-  {                                                                    \
-    bbtkDebugMessageInc("Process",1,"=> "<<bbGetTypeName()<<"::bbUserCreateWidget() [" \
-                       <<bbGetFullName()<<"]"<<std::endl);             \
-    CALLBACK();                                                                \
-    bbtkDebugMessageDec("Process",1,"<= "<<bbGetTypeName()<<"::bbUserCreateWidget() [" \
-                       <<bbGetFullName()<<"]"<<std::endl);             \
-  }
-  
-  //======================================================================
-
   //=================================================================
   // WxBlackBoxDescriptor declaration
-  BBTK_BEGIN_DESCRIBE_BLACK_BOX(WxBlackBox,bbtk::AtomicBlackBox);
+  //
+  class WxBlackBoxDescriptor : public WidgetBlackBoxDescriptor<wxWindow>
+  BBTK_BEGIN_DESCRIBE_BLACK_BOX_BODY(WxBlackBox);
   BBTK_NAME("WxBlackBox");
-  // 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(WxBlackBox,WinTitle,
-            "Title of the window (*)",
-            std::string,"");
-  BBTK_INPUT(WxBlackBox,WinWidth,
-            "Width of the window (* : only used if the widget is not inserted in another widget)",int,"");
-  BBTK_INPUT(WxBlackBox,WinHeight,
-            "Height of the window (*)",int,"");
-  BBTK_INPUT(WxBlackBox,WinDialog,
-            "Set to 'true' to create a dialog window, i.e. which blocks the pipeline until it is closed (modal) (*)",bool,"");
-  BBTK_INPUT(WxBlackBox,WinHide,
-            "Any signal received hides the window (*)",Void,"");
-  BBTK_OUTPUT(WxBlackBox,Widget,"Output widget",wxWindow*,"");
   BBTK_END_DESCRIBE_BLACK_BOX(WxBlackBox);
   //=================================================================
 
@@ -232,81 +147,46 @@ namespace bbtk
 
 
 
-  //==================================================================
-  // The base of the hierarchy of windows associated to a WxBlackBox
-  class BBTK_EXPORT WxBlackBoxWindow //: public wxWindow
-  {
-  public:
-    WxBlackBoxWindow(WxBlackBox* box);
-    virtual ~WxBlackBoxWindow();
-    virtual void bbShow();
-    virtual void bbHide();
-    bool bbIsShown() { return mShown; }
-    virtual WxBlackBox* bbGetBlackBox() { return mBox; }
-    virtual wxDialog* bbGetDialog() { return 0; } 
-    virtual wxFrame* bbGetFrame() { return 0; } 
-  private:
-    WxBlackBox* mBox;
-    bool mShown;
-  };
-  //==================================================================
 
   //==================================================================
   // Dialog window which is modal
-  class BBTK_EXPORT  WxBlackBoxDialog : public wxDialog, public WxBlackBoxWindow
+  class BBTK_EXPORT  WxBlackBoxDialog : public wxDialog, 
+                                       public WidgetBlackBoxWindow<wxWindow>
   {
   public:
-    WxBlackBoxDialog(WxBlackBox* box, 
+    typedef WidgetBlackBoxWindow<wxWindow> Parent;
+    WxBlackBoxDialog(WxBlackBox::Pointer box, 
                     wxWindow *parent, wxString title, wxSize size);
     ~WxBlackBoxDialog();
     void bbShow();  
     void bbHide();
+    void bbClose();
+    bool IsDialog() { return true; }
+    bool IsFrame() { return false; }
     wxDialog* bbGetDialog() { return this; } 
   };
   //==================================================================
 
   //==================================================================
   // Frame window which is not modal
-  class BBTK_EXPORT  WxBlackBoxFrame : public wxFrame, public WxBlackBoxWindow
+  class BBTK_EXPORT  WxBlackBoxFrame : public wxFrame, 
+                                      public WidgetBlackBoxWindow<wxWindow>
   {
   public:
-    WxBlackBoxFrame(WxBlackBox* box,
+    typedef WidgetBlackBoxWindow<wxWindow> Parent;
+    WxBlackBoxFrame(WxBlackBox::Pointer box,
                    wxWindow *parent, wxString title, wxSize size);
     ~WxBlackBoxFrame();
     void bbShow();
     void bbHide();
+    void bbClose();
+    bool IsDialog() { return false; }
+    bool IsFrame() { return true; }
     wxFrame* bbGetFrame() { return this; } 
   };
   //==================================================================
 
 
-  /*
- //=================================================================
-  /// Class from which a user defined widget associated to a WxBlackBox 
-  /// should inherit
-  class BBTK_EXPORT  WxBlackBoxWidget
-  {
-  public:
-    /// Ctor with the WxBlackBox which created it 
-    WxBlackBoxWidget( WxBlackBox* box);
-    /// Dtor
-    virtual ~WxBlackBoxWidget();
-
-    /// Returns the WxBlackBox which created it
-    WxBlackBox* GetBlackBox() { return mBox; }
-    /// Returns the WxBlackBox which created it (const)
-    const WxBlackBox* GetBlackBox() const { return mBox; }
-
-    /// Returns the wxWindow associated to the widget
-    virtual wxWindow* GetWxWindow() { return 0; }
-
-    virtual bool IsDead() { return false; }
-
-  private:
-    WxBlackBox* mBox;
-  };  
-  //=================================================================
-  */
 
   //=================================================================
   // Handles the destroy events of a widget associated to a WxBlackBox 
@@ -315,7 +195,7 @@ namespace bbtk
   {
   public:
     /// Ctor with the box and widget 
-    WxBlackBoxWidgetEventHandler( WxBlackBox* box, wxWindow *widget );
+    WxBlackBoxWidgetEventHandler( WxBlackBox::Pointer box, wxWindow *widget );
     /// Dtor
     ~WxBlackBoxWidgetEventHandler();
     /// Returns true iff is the handler for that window  
@@ -327,41 +207,16 @@ namespace bbtk
     //bool IsDead() { return mDead; }
 
   private:
-    WxBlackBox* mBox;
+    WxBlackBox::WeakPointer mBox;
     wxWindow* mWindow;
     //bool mDead;
   };  
   //=================================================================
 
-  /*
-  //=================================================================
-  /// A WxBlackBoxWidget which is a wxPanel also
-  class BBTK_EXPORT  WxBlackBoxWidgetPanel :     
-                               public wxPanel,
-                               public WxBlackBoxWidget
-//                             public WxBlackBoxWidget,
-//                             public wxPanel
-  {
-  public:
-    /// Ctor with the parent and the WxBlackBox which created it 
-    WxBlackBoxWidgetPanel(WxBlackBox* box,  wxWindow *parent)
-      :
-      wxPanel( parent, -1, wxDefaultPosition, wxDefaultSize, wxTAB_TRAVERSAL),
-      WxBlackBoxWidget(box)
-    {}
-    
-    /// Returns the top panel of the widget    
-    wxWindow* GetWxWindow() { return (wxWindow*)(wxPanel*)(this); }
-    /// Returns the top panel of the widget    
-    wxPanel* GetPanel() { return (wxPanel*)(this); }
-
-  };  
-  //=================================================================
-  */
 
 
 } //namespace bbtk
 
 #endif  //__bbtkWxBlackBox_h__
 
-#endif  //_USE_WXWIDGETS_
+#endif  //USE_WXWIDGETS