bbtkWxBlackBox.h

Go to the documentation of this file.

/*=========================================================================                                                                               
  Program:   bbtk
  Module:    $RCSfile: bbtkWxBlackBox.h,v $
  Language:  C++
  Date:      $Date: 2008/10/17 08:18:15 $
  Version:   $Revision: 1.18 $
========================================================================*/


/* ---------------------------------------------------------------------

* 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.
* ------------------------------------------------------------------------ */                                                                         
#ifdef _USE_WXWIDGETS_


#ifndef __bbtkWxBlackBox_h__
#define __bbtkWxBlackBox_h__


#include "bbtkWx.h"
#include "bbtkAtomicBlackBox.h"


namespace bbtk
{




  //==================================================================
  // Forward declaration of the class of window associated to a WxBlackBox
  class WxBlackBoxWindow;
  //==================================================================

  //==================================================================
  // Forward declaration of the widget event handler class
  class WxBlackBoxWidgetEventHandler;
  //==================================================================


  //==================================================================
  class BBTK_EXPORT WxBlackBox : public bbtk::AtomicBlackBox  
  { 
    BBTK_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_INPUT(WinClose,Void);
    BBTK_DECLARE_OUTPUT(Widget, wxWindow*);//WxBlackBoxWidget*);

  public:
    virtual void bbExecute(bool force = false);


    typedef WxBlackBoxWindow Window;
    
    Window* bbGetWindow() { return bbmWindow; }

    Window* bbGetContainingWindow();

    wxWindow* bbGetWxParent();

    bool bbIsShown();

    //==================================================================    
    virtual void bbUserOnShow() {}
    //==================================================================    
 
    //==================================================================    
    virtual void bbUserOnHide() {}
    //==================================================================    

  protected:
    
  
    //==================================================================
    virtual void bbUserConstructor();
    virtual void bbUserCopyConstructor();
    virtual void bbUserDestructor();
    //==================================================================    

    //==================================================================    
    virtual void bbUserCreateWidget() 
    {
      bbtkError(bbGetTypeName()<<" is a WxBlackBox whose bbUserCreateWidget methods is not overloaded : is it a feature or a bug ?!?");
    }
    //==================================================================    


    

    //==================================================================
    virtual IOStatus bbBackwardUpdate( Connection::Pointer caller );
    //==================================================================



    //==================================================================
    virtual void bbProcess();
    //==================================================================

    //==================================================================
    void bbShowWindow();
    void bbHideWindow();
    void bbCloseWindow();
    //==================================================================

  private:
    friend class WxBlackBoxWindow;
    friend class WxBlackBoxWidgetEventHandler;

    inline void bbSetWindow(Window* w) { bbmWindow=w; }

    inline void bbSetWidgetEventHandler(WxBlackBoxWidgetEventHandler* w) 
    { bbmWidgetEventHandler = w; }
    inline WxBlackBoxWidgetEventHandler* bbGetWidgetEventHandler()
    { return bbmWidgetEventHandler; }


    Window* bbmWindow;
    WxBlackBoxWidgetEventHandler* bbmWidgetEventHandler;


    void bbInitAttributes();

  protected :


    bool bbmUpdateTransferedToParent;

    bool bbGetUpdateTransferedToParent() const { return bbmUpdateTransferedToParent; }
    void bbSetUpdateTransferedToParent(bool b) 
    { bbmUpdateTransferedToParent = b; }

  };
  //=================================================================
 

  //======================================================================
#define BBTK_CREATE_WIDGET(CALLBACK)                                    \
  public:                                                               \
  inline void bbUserCreateWidget()                                      \
  {                                                                     \
    bbtkDebugMessageInc("process",1,"**> Creating widget for ["         \
                        <<bbGetFullName()<<"]"<<std::endl);             \
    CALLBACK();                                                         \
    bbtkDebugMessageInc("process",2,"<** Creating widget for ["         \
                        <<bbGetFullName()<<"]"<<std::endl);             \
  }
  
  //======================================================================

  //=================================================================
  // WxBlackBoxDescriptor declaration
  BBTK_BEGIN_DESCRIBE_BLACK_BOX(WxBlackBox,bbtk::AtomicBlackBox);
  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 connected to a Layout box)",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,"signal");
  BBTK_INPUT(WxBlackBox,WinClose,
             "Any signal received closes the window (*)",Void,"signal");
  BBTK_OUTPUT(WxBlackBox,Widget,"Output widget",wxWindow*,"");
  BBTK_END_DESCRIBE_BLACK_BOX(WxBlackBox);
  //=================================================================









  //==================================================================
  // The base of the hierarchy of windows associated to a WxBlackBox
  class BBTK_EXPORT WxBlackBoxWindow //: public wxWindow
  {
  public:
    WxBlackBoxWindow(WxBlackBox::Pointer box);
    virtual ~WxBlackBoxWindow();
    virtual void bbShow();
    virtual void bbHide();
    virtual void bbClose();
    bool bbIsShown() { return mShown; }
    virtual WxBlackBox::Pointer bbGetBlackBox() { return mBox.lock(); }
    virtual wxDialog* bbGetDialog() { return 0; } 
    virtual wxFrame* bbGetFrame() { return 0; } 
  private:
    WxBlackBox::WeakPointer mBox;
    bool mShown;
  };
  //==================================================================

  //==================================================================
  // Dialog window which is modal
  class BBTK_EXPORT  WxBlackBoxDialog : public wxDialog, public WxBlackBoxWindow
  {
  public:
    WxBlackBoxDialog(WxBlackBox::Pointer box, 
                     wxWindow *parent, wxString title, wxSize size);
    ~WxBlackBoxDialog();
    void bbShow();  
    void bbHide();
    void bbClose();
    wxDialog* bbGetDialog() { return this; } 
  };
  //==================================================================

  //==================================================================
  // Frame window which is not modal
  class BBTK_EXPORT  WxBlackBoxFrame : public wxFrame, public WxBlackBoxWindow
  {
  public:
    WxBlackBoxFrame(WxBlackBox::Pointer box,
                    wxWindow *parent, wxString title, wxSize size);
    ~WxBlackBoxFrame();
    void bbShow();
    void bbHide();
    void bbClose();
    wxFrame* bbGetFrame() { return this; } 
  };
  //==================================================================



  //=================================================================
  // Handles the destroy events of a widget associated to a WxBlackBox 
  // in order to signal the widget death to its associated box
  class BBTK_EXPORT WxBlackBoxWidgetEventHandler : public wxEvtHandler
  {
  public:
    WxBlackBoxWidgetEventHandler( WxBlackBox::Pointer box, wxWindow *widget );
    ~WxBlackBoxWidgetEventHandler();
    bool IsHandlerOf( wxWindow* w ) { return mWindow == w; }
    // wxWindow* GetWxWindow() { return mWindow; }
    void OnWindowDestroy(wxWindowDestroyEvent&);
    //
    //bool IsDead() { return mDead; }

  private:
    WxBlackBox::WeakPointer mBox;
    wxWindow* mWindow;
    //bool mDead;
  };  
  //=================================================================



} //namespace bbtk

#endif  //__bbtkWxBlackBox_h__

#endif  //_USE_WXWIDGETS_