/*************************************************************************** kmultitabbar.h - description ------------------- begin : 2001 copyright : (C) 2001,2002,2003 by Joseph Wenninger (C) 2005 by Mark Kretschmann ***************************************************************************/ /*************************************************************************** This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details. You should have received a copy of the GNU Library General Public License along with this library; see the file COPYING.LIB. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. ***************************************************************************/ #ifndef _Multitabbar_h_ #define _Multitabbar_h_ #include #include #include #include #include #include #include class TQPixmap; class TQPainter; class TQFrame; class MultiTabBarPrivate; class MultiTabBarTabPrivate; class MultiTabBarButtonPrivate; class MultiTabBarInternal; // this exists only because dropEvent is protected class DropProxyTarget { public: virtual void dropProxyEvent( TQDropEvent *e ) = 0; }; /** * A Widget for horizontal and vertical tabs. * It is possible to add normal buttons to the top/left * The handling if only one tab at a time or multiple tabs * should be raisable is left to the "user". *@author Joseph Wenninger */ class MultiTabBar: public TQWidget { Q_OBJECT TQ_OBJECT public: enum MultiTabBarMode{Horizontal, Vertical}; enum MultiTabBarPosition{Left, Right, Top, Bottom}; /** * VSNET == Visual Studio .Net like (only show the text of active tabs * KDEV3 == Kdevelop 3 like (always show the text) * KONTQSBC == konqy's classic sidebar style (unthemed), this one is disabled * at the moment, but will be renabled soon too */ enum MultiTabBarStyle{VSNET = 0, KDEV3 = 1, KONTQSBC = 2, KDEV3ICON = 3, AMAROK = 4, STYLELAST = 0xffff}; MultiTabBar( MultiTabBarMode bm, TQWidget *tqparent = 0, const char *name = 0 ); virtual ~MultiTabBar(); /** * append a new button to the button area. The button can later on be accessed with button(ID) * eg for connecting signals to it * @param pic a pixmap for the button * @param id an arbitraty ID value. It will be emitted in the clicked signal for identifying the button * if more than one button is connected to a signals. * @param popup A popup menu which should be displayed if the button is clicked * @param not_used_yet will be used for a popup text in the future */ int appendButton( const TQPixmap &pic, int id = -1, TQPopupMenu* popup = 0, const TQString& not_used_yet = TQString() ); /** * remove a button with the given ID */ void removeButton( int id ); /** * append a new tab to the tab area. It can be accessed lateron with tabb(id); * @param pic a bitmap for the tab * @param id an arbitrary ID which can be used later on to identify the tab * @param text if a mode with text is used it will be the tab text, otherwise a mouse over hint * @param identifier for storing visibility to config file */ int appendTab( const TQPixmap &pic, int id = -1, const TQString& text = TQString(), const TQString& identifier = TQString() ); /** * remove a tab with a given ID */ void removeTab( int id ); /** * set a tab to "raised" * @param id The ID of the tab to manipulate * @param state true == activated/raised, false == not active */ void setTab( int id , bool state ); /** * return the state of a tab, identified by it's ID */ bool isTabRaised( int id ) const; /** * get a pointer to a button within the button area identified by its ID */ class MultiTabBarButton *button( int id ) const; /** * get a pointer to a tab within the tab area, identiifed by its ID */ class MultiTabBarTab *tab( int id ) const; /** * set the real position of the widget. * @param pos if the mode is horizontal, only use top, bottom, if it is vertical use left or right */ void setPosition( MultiTabBarPosition pos ); /** * set the display style of the tabs */ void setStyle( MultiTabBarStyle style ); /** * be carefull, don't delete tabs yourself and don't delete the list itself */ TQPtrList* tabs(); /** * be carefull, don't delete buttons yourself and don't delete the list itself */ TQPtrList* buttons(); /** * might vanish, not sure yet */ void showActiveTabTexts( bool show = true ); /** * @return number of visible tabs */ uint visibleTabCount(); /** * @return height per tab */ uint sizePerTab(); void showTabSelectionMenu(TQPoint pos); protected: friend class MultiTabBarButton; virtual void fontChange( const TQFont& ); void updateSeparator(); private: class MultiTabBarInternal *m_internal; TQBoxLayout *m_l; TQFrame *m_btnTabSep; TQPtrList m_buttons; MultiTabBarPosition m_position; MultiTabBarPrivate *d; }; /** * This class should never be created except with the appendButton call of MultiTabBar */ class MultiTabBarButton: public TQPushButton { Q_OBJECT TQ_OBJECT public: MultiTabBarButton( const TQPixmap& pic, const TQString&, TQPopupMenu *popup, int id, TQWidget *tqparent, MultiTabBar::MultiTabBarPosition pos, MultiTabBar::MultiTabBarStyle style ); MultiTabBarButton( const TQString&, TQPopupMenu *popup, int id, TQWidget *tqparent, MultiTabBar::MultiTabBarPosition pos, MultiTabBar::MultiTabBarStyle style ); virtual ~MultiTabBarButton(); int id() const; public slots: /** * this is used internaly, but can be used by the user, if (s)he wants to * It the according call of MultiTabBar is invoked though this modifications will be overwritten */ void setPosition( MultiTabBar::MultiTabBarPosition ); /** * this is used internaly, but can be used by the user, if (s)he wants to * It the according call of MultiTabBar is invoked though this modifications will be overwritten */ void setStyle( MultiTabBar::MultiTabBarStyle ); /** * modify the text of the button */ void setText( const TQString & ); /** * make this a drop proxy for finalDropTarget */ void proxyDrops( DropProxyTarget *finalDropTarget ); TQSize tqsizeHint() const; protected: static const int ANIM_INTERVAL = 18; static const int ANIM_MAX = 20; MultiTabBar::MultiTabBarPosition m_position; MultiTabBar::MultiTabBarStyle m_style; TQString m_text; int m_id; bool m_animEnter; int m_animCount; class TQTimer* m_animTimer; class TQTimer* m_dragSwitchTimer; virtual void hideEvent( class TQHideEvent* ); virtual void showEvent( class TQShowEvent* ); virtual void enterEvent( class TQEvent* ); virtual void leaveEvent( class TQEvent* ); virtual void dragEnterEvent ( class TQDragEnterEvent * ); virtual void dragMoveEvent ( class TQDragMoveEvent * ); virtual void dragLeaveEvent ( class TQDragLeaveEvent * ); virtual void dropEvent( class TQDropEvent * ); private: MultiTabBarButtonPrivate *d; signals: /** * this is emitted if the button is clicked * @param id the ID identifying the button */ void clicked( int id ); void initiateDrag ( int id ); protected slots: virtual void slotClicked(); virtual void slotAnimTimer(); virtual void slotDragSwitchTimer(); }; /** * This class should never be created except with the appendTab call of MultiTabBar */ class MultiTabBarTab: public MultiTabBarButton { Q_OBJECT TQ_OBJECT public: MultiTabBarTab( const TQPixmap& pic, const TQString&, int id, TQWidget *tqparent, MultiTabBar::MultiTabBarPosition pos, MultiTabBar::MultiTabBarStyle style ); virtual ~MultiTabBarTab(); /** * set the active state of the tab * @param state true==active false==not active */ void setState( bool state ); /** * choose if the text should always be displayed * this is only used in classic mode if at all */ void showActiveTabText( bool show ); void resize() { setSize( neededSize() ); } bool visible() { return m_visible; }; void setVisible( bool visible) { m_visible = visible; }; void setIdentifier( const TQString &id ) { m_identifier = id; } const TQString &identifier() const { return m_identifier; } private: bool m_visible; bool m_showActiveTabText; int m_expandedSize; TQString m_identifier; MultiTabBarTabPrivate *d; protected: friend class MultiTabBarInternal; void setSize( int ); int neededSize(); void updateState(); virtual void drawButton( TQPainter * ); virtual void drawButtonLabel( TQPainter * ); void drawButtonStyled( TQPainter * ); void drawButtonClassic( TQPainter * ); void drawButtonAmarok( TQPainter * ); TQColor blendColors( const TQColor& color1, const TQColor& color2, int percent ); protected slots: virtual void slotClicked(); void setTabsPosition( MultiTabBar::MultiTabBarPosition ); public slots: virtual void setIcon( const TQString& ); virtual void setIcon( const TQPixmap& ); }; #endif