-/*=========================================================================
-
+/*=========================================================================
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: 2008/12/11 15:30:04 $
+ Version: $Revision: 1.24 $
+========================================================================*/
+
+
+/* ---------------------------------------------------------------------
+
+* 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
*/
-#ifdef _USE_WXWIDGETS_
+#ifdef USE_WXWIDGETS
#ifndef __bbtkWxBlackBox_h__
//==================================================================
/// Widget black boxes
class BBTK_EXPORT WxBlackBox : public bbtk::AtomicBlackBox
- {
- BBTK_USER_BLACK_BOX_INTERFACE(WxBlackBox,bbtk::AtomicBlackBox);
- // BBTK_DECLARE_INPUT(WinParent,WxParentToChildData*);
+ {
+ BBTK_BLACK_BOX_INTERFACE(WxBlackBox,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_OUTPUT(Widget, wxWindow*);//WxBlackBoxWidget*);
+ BBTK_DECLARE_INPUT(WinClose,Void);
+ BBTK_DECLARE_OUTPUT(Widget, wxWindow*);
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 WxBlackBoxWindow Window;
/// Returns the **OWN** window associated to the box
/// 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();
virtual void bbUserOnHide() {}
//==================================================================
+
+ //==================================================================
+ void bbCreateWidgetAndEventHandler(wxWindow* parent);
+ //==================================================================
+
protected:
/// User callback called in the box contructor
virtual void bbUserConstructor();
/// User callback called in the box copy constructor
- virtual void bbUserCopyConstructor();
+ virtual void bbUserCopyConstructor(bbtk::BlackBox::Pointer);
/// User callback called in the box destructor
virtual void bbUserDestructor();
//==================================================================
//==================================================================
/// User callback for creating the widget associated to the box
/// ** Must be defined **
- virtual void bbUserCreateWidget()
+ virtual void bbUserCreateWidget(wxWindow* parent)
{
bbtkError(bbGetTypeName()<<" is a WxBlackBox whose bbUserCreateWidget methods is not overloaded : is it a feature or a bug ?!?");
}
//==================================================================
-
-
- //==================================================================
- /// Main processing method of the box.
- virtual IOStatus bbBackwardUpdate( Connection* caller );
- //==================================================================
-
+ //==================================================================
+ // For layout widgets : creates and returns the widget
+ // of the box connected to input in
+ wxWindow* bbCreateWidgetOfInput(const std::string& in, wxWindow* parent);
+ //==================================================================
+
//==================================================================
- /// 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();
+ /// Overloaded processing method for WxBlackBoxes which handles
+ /// the window creation if needed
virtual void bbProcess();
//==================================================================
/// (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();
+ // void bbShowWindow();
/// Hides the WxBlackBoxWindow associated to the box (if exists)
void bbHideWindow();
+ /// Closes (destroys) the WxBlackBoxWindow associated to the box (if exists)
+ void bbCloseWindow();
//==================================================================
private:
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);
+
+ /// 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_WIDGET(CALLBACK) \
public: \
- inline void bbUserCreateWidget() \
+ inline void bbUserCreateWidget(wxWindow* parent) \
+ { \
+ bbtkDebugMessageInc("wx",1,"**> Creating widget for [" \
+ <<bbGetFullName()<<"]"<<std::endl); \
+ CALLBACK(parent); \
+ bbtkDebugMessageInc("wx",1,"<** Creating widget for [" \
+ <<bbGetFullName()<<"]"<<std::endl); \
+ }
+
+ //======================================================================
+
+ //======================================================================
+ /// Defines the bbUserOnShow method
+#define BBTK_ON_SHOW_WIDGET(CALLBACK) \
+ public: \
+ inline void bbUserOnShow() \
{ \
- bbtkDebugMessageInc("Process",1,"=> "<<bbGetTypeName()<<"::bbUserCreateWidget() [" \
+ bbtkDebugMessageInc("wx",1,"**> Showing [" \
<<bbGetFullName()<<"]"<<std::endl); \
CALLBACK(); \
- bbtkDebugMessageDec("Process",1,"<= "<<bbGetTypeName()<<"::bbUserCreateWidget() [" \
+ bbtkDebugMessageInc("wx",1,"<** Showing [" \
<<bbGetFullName()<<"]"<<std::endl); \
}
"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,"");
+ "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,"");
+ "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);
//=================================================================
class BBTK_EXPORT WxBlackBoxWindow //: public wxWindow
{
public:
- WxBlackBoxWindow(WxBlackBox* box);
+ WxBlackBoxWindow(WxBlackBox::Pointer box);
virtual ~WxBlackBoxWindow();
virtual void bbShow();
virtual void bbHide();
+ virtual void bbClose();
bool bbIsShown() { return mShown; }
- virtual WxBlackBox* bbGetBlackBox() { return mBox; }
+ virtual WxBlackBox::Pointer bbGetBlackBox() { return mBox.lock(); }
virtual wxDialog* bbGetDialog() { return 0; }
virtual wxFrame* bbGetFrame() { return 0; }
private:
- WxBlackBox* mBox;
+ WxBlackBox::WeakPointer mBox;
bool mShown;
};
//==================================================================
class BBTK_EXPORT WxBlackBoxDialog : public wxDialog, public WxBlackBoxWindow
{
public:
- WxBlackBoxDialog(WxBlackBox* box,
+ WxBlackBoxDialog(WxBlackBox::Pointer box,
wxWindow *parent, wxString title, wxSize size);
~WxBlackBoxDialog();
void bbShow();
void bbHide();
+ void bbClose();
wxDialog* bbGetDialog() { return this; }
};
//==================================================================
class BBTK_EXPORT WxBlackBoxFrame : public wxFrame, public WxBlackBoxWindow
{
public:
- WxBlackBoxFrame(WxBlackBox* box,
+ WxBlackBoxFrame(WxBlackBox::Pointer box,
wxWindow *parent, wxString title, wxSize size);
~WxBlackBoxFrame();
void bbShow();
void bbHide();
+ void bbClose();
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
{
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
//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