1 /*# ---------------------------------------------------------------------
3 # Copyright (c) CREATIS (Centre de Recherche en Acquisition et Traitement de l'Image
5 # Authors : Eduardo Davila, Frederic Cervenansky, Claire Mouton
6 # Previous Authors : Laurent Guigues, Jean-Pierre Roux
7 # CreaTools website : www.creatis.insa-lyon.fr/site/fr/creatools_accueil
9 # This software is governed by the CeCILL-B license under French law and
10 # abiding by the rules of distribution of free software. You can use,
11 # modify and/ or redistribute the software under the terms of the CeCILL-B
12 # license as circulated by CEA, CNRS and INRIA at the following URL
13 # http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.html
14 # or in the file LICENSE.txt.
16 # As a counterpart to the access to the source code and rights to copy,
17 # modify and redistribute granted by the license, users are provided only
18 # with a limited warranty and the software's author, the holder of the
19 # economic rights, and the successive licensors have only limited
22 # The fact that you are presently reading this means that you have had
23 # knowledge of the CeCILL-B license and that you accept its terms.
24 # ------------------------------------------------------------------------ */
28 * @brief Contains the Button class.
29 * @author Diego CACERES (diego.caceres[AT]creatis.insa-lyon.fr)
36 #include <wx/bmpbuttn.h>
38 #include <wx/string.h>
39 #include <wx/bitmap.h>
43 /*! @namespace <creaButtonContainer>
44 * @brief Contains the creaButtonContainer library included in creaMaracasVisu.
46 namespace creaButtonContainer
48 /*! @namespace <creaButtonContainer::view>
49 * @brief Contains the implementation of the view in creaButtonContainer library.
50 * @see <a href="http://en.wikipedia.org/wiki/Model-view-controller">MVC Software Architecture</a>
54 /*! @class Button button.h "button.h"
55 * @brief This class contains the Button in the view perspective.
56 * @details This class contains the information of a button, it derives from wxBitmapButton.
57 * @see <a href="http://docs.wxwidgets.org/stable/wx_wxbitmapbutton.html">wxBitmapButton</a>
59 class Button : public wxBitmapButton
63 // ----------------------------------------------------------------------------------
64 /*! @typedef creaButtonContainer::model::TFunctor TFunctor;
65 * @brief Defines the TFunctor type.
67 typedef creaButtonContainer::model::TFunctor TFunctor;
68 // ----------------------------------------------------------------------------------
69 //end of typedef definition
72 // ----------------------------------------------------------------------------------
73 /*! @fn Button::Button( wxWindow* parent, long id, ButtonPair* pair );
74 * @brief This is the constructor.
75 * @param parent The wxWindow* parent.
76 * @param id The wxID of the button.
77 * @param pair The button information.
79 Button( wxWindow* parent, long id, ButtonPair* pair );
80 // ----------------------------------------------------------------------------------
81 /*! @fn virtual Button::~Button( );
82 * @brief This is the destructor.
86 // ----------------------------------------------------------------------------------
87 /*! @fn long Button::GetID( );
88 * @brief This method gets the wxID of the button.
89 * @return long wxID of the button.
93 // ----------------------------------------------------------------------------------
94 /*! @fn std::string Button::GetButtonName( );
95 * @brief This method returns the name of the button.
96 * @return std::string The name of the button.
101 // ----------------------------------------------------------------------------------
102 /*! @fn std::string Button::GetIconPath( );
103 * @brief This method returns the iconPath of the button.
104 * @return std::string The path of the icon.
109 // ----------------------------------------------------------------------------------
110 /*! @fn std::string Button::GetIconPath( );
111 * @brief This method returns the iconPath of the button.
112 * @return std::string The path of the icon.
116 // ----------------------------------------------------------------------------------
117 /*! @fn std::string Button::GetDescription( );
118 * @brief This method returns a the description of the button.
119 * @return std::string The tooltip of the button.
123 // ----------------------------------------------------------------------------------
124 /*! @fn void Button::Execute( );
125 * @brief This method executes the Functor (Call_Back Function).
126 * This is the event of the button that it was defined to be called remotely using
127 * call_back functions. In this project it was implemented using Functors.
128 * @exception std::bad_alloc
133 // ----------------------------------------------------------------------------------
135 ButtonPair* m_ButtonPair; //! <The pair with the button information.