1 /*****************************************************************************
3 *****************************************************************************
4 * Copyright (C) 2003 VideoLAN
7 * Authors: Cyril Deguet <asmax@via.ecp.fr>
8 * Olivier Teulière <ipkiss@via.ecp.fr>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
23 *****************************************************************************/
25 #ifndef CTRL_GENERIC_HPP
26 #define CTRL_GENERIC_HPP
28 #include "../src/skin_common.hpp"
29 #include "../utils/pointer.hpp"
30 #include "../utils/fsm.hpp"
31 #include "../utils/ustring.hpp"
32 #include "../utils/observer.hpp"
42 /// Base class for controls
43 class CtrlGeneric: public SkinObject, public Observer<VarBool>
46 virtual ~CtrlGeneric();
48 /// Handle an event on the control
49 virtual void handleEvent( EvtGeneric &rEvent ) {}
51 /// Check whether coordinates are inside the control
52 virtual bool mouseOver( int x, int y ) const { return false; }
54 /// Draw the control on the given graphics
55 virtual void draw( OSGraphics &rImage, int xDest, int yDest ) {}
57 /// Set the position and the associated layout of the control
58 virtual void setLayout( GenericLayout *pLayout,
59 const Position &rPosition );
61 /// Get the position of the control in the layout, if any
62 virtual const Position *getPosition() const { return m_pPosition; }
64 /// Get the text of the tooltip
65 virtual UString getTooltipText() const
66 { return UString( getIntf(), "" ); }
68 /// Overload this method if you want to do something special when
69 /// the layout is resized
70 virtual void onResize() {}
73 virtual const UString &getHelpText() const { return m_help; }
75 /// Return true if the control can gain the focus
76 virtual bool isFocusable() const { return false; }
78 /// Return true if the control is visible
79 virtual bool isVisible() const;
82 // If pVisible is NULL, the control is always visible
83 CtrlGeneric( intf_thread_t *pIntf, const UString &rHelp,
84 VarBool *pVisible = NULL );
86 /// Tell the layout when the image has changed
87 virtual void notifyLayout() const;
89 /// Ask the layout to capture the mouse
90 virtual void captureMouse() const;
92 /// Ask the layout to release the mouse
93 virtual void releaseMouse() const;
95 /// Notify the window the tooltip has changed
96 virtual void notifyTooltipChange() const;
98 /// Get the associated window, if any
99 virtual TopWindow *getWindow() const;
101 /// Overload this method if you want to do something special when
102 /// the Position object is set
103 virtual void onPositionChange() {}
105 /// Overload this method to get notified of bool variable changes
106 virtual void onVarBoolUpdate( VarBool &rVar ) {}
109 /// Associated layout
110 GenericLayout *m_pLayout;
111 /// Position in the layout
112 Position *m_pPosition;
115 /// Visibilty variable
118 /// Method called when an observed bool variable is changed
119 virtual void onUpdate( Subject<VarBool> &rVariable );
122 typedef CountedPtr<CtrlGeneric> CtrlGenericPtr;