ktabwidget.h

/* This file is part of the KDE libraries
    Copyright (C) 2003 Stephan Binner <binner@kde.org>
    Copyright (C) 2003 Zack Rusin <zack@kde.org>
 
    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 KTABWIDGET_H
#define KTABWIDGET_H
 
#include <tqtabwidget.h>
#include <tqstringlist.h>
 
#include <tdelibs_export.h>
 
class KTabWidgetPrivate;

class TDEUI_EXPORT KTabWidget : public TQTabWidget
{
    TQ_OBJECT
    TQ_PROPERTY( bool tabReorderingEnabled READ isTabReorderingEnabled WRITE setTabReorderingEnabled )
    TQ_PROPERTY( bool hoverCloseButton READ hoverCloseButton WRITE setHoverCloseButton )
    TQ_PROPERTY( bool hoverCloseButtonDelayed READ hoverCloseButtonDelayed WRITE setHoverCloseButtonDelayed )
    TQ_PROPERTY( bool tabCloseActivatePrevious READ tabCloseActivatePrevious WRITE setTabCloseActivatePrevious )
    TQ_PROPERTY( bool automaticResizeTabs READ automaticResizeTabs WRITE setAutomaticResizeTabs )
 
public:
    KTabWidget( TQWidget *parent = 0, const char *name = 0, WFlags f = 0 );

    virtual ~KTabWidget();

    void setTabColor( TQWidget *, const TQColor& color );

    void resetTabColor( TQWidget * );

    TQColor tabColor( TQWidget * ) const;

    bool isTabReorderingEnabled() const;

    bool hoverCloseButton() const;

    bool hoverCloseButtonDelayed() const;

    bool tabCloseActivatePrevious() const;

    bool automaticResizeTabs() const;

    void setTabBarHidden( bool hide );

    bool isTabBarHidden() const;

    void setMouseWheelScroll(bool mouseWheelScroll);

    virtual void insertTab( TQWidget *, const TQString &, int index = -1 );

    virtual void insertTab( TQWidget *child, const TQIconSet& iconset,
                            const TQString &label, int index = -1 );
    virtual void insertTab( TQWidget *, TQTab *, int index = -1 );

    void changeTab( TQWidget *, const TQString & );

    void changeTab( TQWidget *child, const TQIconSet& iconset, const TQString &label );

    TQString label( int ) const;

    TQString tabLabel( TQWidget * ) const;

    void setTabLabel( TQWidget *, const TQString & );
 
public slots:
    virtual void moveTab( int, int );

    virtual void removePage ( TQWidget * w );

    void setTabReorderingEnabled( bool enable );

    void setHoverCloseButton( bool enable );

    void setHoverCloseButtonDelayed( bool delayed );

    void setTabCloseActivatePrevious( bool previous );

    void setAutomaticResizeTabs( bool enable );
 
signals:
    void testCanDecode(const TQDragMoveEvent *e, bool &accept /* result */);

    void receivedDropEvent( TQDropEvent * );

    void receivedDropEvent( TQWidget *, TQDropEvent * );

    void initiateDrag( TQWidget * );

    void contextMenu( const TQPoint & );

    void contextMenu( TQWidget *, const TQPoint & );

    void movedTab( int, int );

    void mouseDoubleClick();

    void mouseDoubleClick( TQWidget * );

    void mouseMiddleClick();

    void mouseMiddleClick( TQWidget * );

    void closeRequest( TQWidget * );
 
protected:
    virtual void mouseDoubleClickEvent( TQMouseEvent *e );
    virtual void mousePressEvent( TQMouseEvent * );
    virtual void dragMoveEvent( TQDragMoveEvent * );
    virtual void dropEvent( TQDropEvent * );
    unsigned int tabBarWidthForMaxChars( uint maxLength );
#ifndef TQT_NO_WHEELEVENT
    virtual void wheelEvent( TQWheelEvent *e );
#endif
    virtual void resizeEvent( TQResizeEvent * );
 
protected slots:
    virtual void receivedDropEvent( int, TQDropEvent * );
    virtual void initiateDrag( int );
    virtual void contextMenu( int, const TQPoint & );
    virtual void mouseDoubleClick( int );
    virtual void mouseMiddleClick( int );
    virtual void closeRequest( int );
#ifndef TQT_NO_WHEELEVENT
    virtual void wheelDelta( int );
#endif
 
private:
    bool isEmptyTabbarSpace( const TQPoint & )  const;
    void resizeTabs( int changedTabIndex = -1 );
    void updateTab( int index );
 
    KTabWidgetPrivate *d;
};
 
#endif