Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 294 insertions, 0 deletions

diff --git a/kdeui/ktabwidget.h b/kdeui/ktabwidget.h
new file mode 100644
index 000000000..971c4af1d
--- /dev/null
+++ b/kdeui/ktabwidget.h
@@ -0,0 +1,294 @@
+/* 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 <qtabwidget.h>
+#include <qstringlist.h>
+
+#include <kdelibs_export.h>
+
+class KTabWidgetPrivate;
+
+/**
+ * \brief A widget containing multiple tabs
+ *
+ * @since 3.2
+ */
+class KDEUI_EXPORT KTabWidget : public QTabWidget
+{
+    Q_OBJECT
+    Q_PROPERTY( bool tabReorderingEnabled READ isTabReorderingEnabled WRITE setTabReorderingEnabled )
+    Q_PROPERTY( bool hoverCloseButton READ hoverCloseButton WRITE setHoverCloseButton )
+    Q_PROPERTY( bool hoverCloseButtonDelayed READ hoverCloseButtonDelayed WRITE setHoverCloseButtonDelayed )
+    Q_PROPERTY( bool tabCloseActivatePrevious READ tabCloseActivatePrevious WRITE setTabCloseActivatePrevious )
+    Q_PROPERTY( bool automaticResizeTabs READ automaticResizeTabs WRITE setAutomaticResizeTabs )
+
+public:
+    KTabWidget( QWidget *parent = 0, const char *name = 0, WFlags f = 0 );
+    /**
+     * Destructor.
+     */
+    virtual ~KTabWidget();
+    /*!
+      Set the tab of the given widget to \a color.
+    */
+    void setTabColor( QWidget *, const QColor& color );
+    /*!
+      Returns the tab color for the given widget.
+    */
+    QColor tabColor( QWidget * ) const;
+
+    /*!
+      Returns true if tab ordering with the middle mouse button
+      has been enabled.
+    */
+    bool isTabReorderingEnabled() const;
+
+    /*!
+      Returns true if the close button is shown on tabs
+      when mouse is hovering over them.
+    */
+    bool hoverCloseButton() const;
+
+    /*!
+      Returns true if the close button is shown on tabs
+      after a delay.
+    */
+    bool hoverCloseButtonDelayed() const;
+
+    /*!
+      Returns true if closing the current tab activates the previous
+      actice tab instead of the one to the right.
+      @since 3.3
+    */
+    bool tabCloseActivatePrevious() const;
+
+    /*!
+      Returns true if calling setTitle() will resize tabs
+      to the width of the tab bar.
+      @since 3.4
+    */
+    bool automaticResizeTabs() const;
+
+    /*!
+      If \a hide is true, the tabbar is hidden along with any corner
+      widgets.
+      @since 3.4
+    */
+    void setTabBarHidden( bool hide );
+
+    /*!
+      Returns true if the tabbar is hidden.
+      @since 3.4
+    */
+    bool isTabBarHidden() const;
+
+    /*!
+      Reimplemented for internal reasons.
+     */
+    virtual void insertTab( QWidget *, const QString &, int index = -1 );
+
+    /*!
+      Reimplemented for internal reasons.
+     */
+    virtual void insertTab( QWidget *child, const QIconSet& iconset,
+                            const QString &label, int index = -1 );
+    /*!
+      Reimplemented for internal reasons.
+    */
+    virtual void insertTab( QWidget *, QTab *, int index = -1 );
+
+    /*!
+      Reimplemented for internal reasons.
+    */
+    void changeTab( QWidget *, const QString & );
+
+    /*!
+      Reimplemented for internal reasons.
+    */
+    void changeTab( QWidget *child, const QIconSet& iconset, const QString &label );
+
+    /*!
+      Reimplemented for internal reasons.
+    */
+    QString label( int ) const;
+
+    /*!
+      Reimplemented for internal reasons.
+    */
+    QString tabLabel( QWidget * ) const;
+
+    /*!
+      Reimplemented for internal reasons.
+    */
+    void setTabLabel( QWidget *, const QString & );
+
+public slots:
+    /*!
+      Move a widget's tab from first to second specified index and emit
+      signal movedTab( int, int ) afterwards.
+    */
+    virtual void moveTab( int, int );
+
+    /*!
+      Removes the widget, reimplemented for
+      internal reasons (keeping labels in sync).
+    */
+    virtual void removePage ( QWidget * w );
+
+    /*!
+      If \a enable is true, tab reordering with middle button will be enabled.
+
+      Note that once enabled you shouldn't rely on previously queried
+      currentPageIndex() or indexOf( QWidget * ) values anymore.
+
+      You can connect to signal movedTab(int, int) which will notify
+      you from which index to which index a tab has been moved.
+    */
+    void setTabReorderingEnabled( bool enable );
+
+    /*!
+      If \a enable is true, a close button will be shown on mouse hover
+      over tab icons which will emit signal closeRequest( QWidget * )
+      when pressed.
+    */
+    void setHoverCloseButton( bool enable );
+
+    /*!
+      If \a delayed is true, a close button will be shown on mouse hover
+      over tab icons after mouse double click delay else immediately.
+    */
+    void setHoverCloseButtonDelayed( bool delayed );
+
+    /*!
+      If \a previous is true, closing the current tab activates the
+      previous active tab instead of the one to the right.
+      @since 3.3
+    */
+    void setTabCloseActivatePrevious( bool previous );
+
+    /*!
+      If \a enable is true, tabs will be resized to the width of the tab bar.
+
+      Does not work reliable with "QTabWidget* foo=new KTabWidget()" and if
+      you change tabs via the tabbar or by accessing tabs directly.
+      @since 3.4
+    */
+    void setAutomaticResizeTabs( bool enable );
+
+signals:
+    /*!
+      Connect to this and set accept to true if you can and want to decode the event.
+    */
+    void testCanDecode(const QDragMoveEvent *e, bool &accept /* result */);
+
+    /*!
+      Received an event in the empty space beside tabbar. Usually creates a new tab.
+      This signal is only possible after testCanDecode and positive accept result.
+    */
+    void receivedDropEvent( QDropEvent * );
+
+    /*!
+      Received an drop event on given widget's tab.
+      This signal is only possible after testCanDecode and positive accept result.
+    */
+    void receivedDropEvent( QWidget *, QDropEvent * );
+
+    /*!
+      Request to start a drag operation on the given tab.
+    */
+    void initiateDrag( QWidget * );
+
+    /*!
+      The right mouse button was pressed over empty space besides tabbar.
+    */
+    void contextMenu( const QPoint & );
+
+    /*!
+      The right mouse button was pressed over a widget.
+    */
+    void contextMenu( QWidget *, const QPoint & );
+
+    /*!
+      A tab was moved from first to second index. This signal is only
+      possible after you have called setTabReorderingEnabled( true ).
+    */
+    void movedTab( int, int );
+
+    /*!
+      A double left mouse button click was performed over empty space besides tabbar.
+      @since 3.3
+    */
+    void mouseDoubleClick();
+
+    /*!
+      A double left mouse button click was performed over the widget.
+    */
+    void mouseDoubleClick( QWidget * );
+
+    /*!
+      A middle mouse button click was performed over empty space besides tabbar.
+    */
+    void mouseMiddleClick();
+
+    /*!
+      A middle mouse button click was performed over the widget.
+    */
+    void mouseMiddleClick( QWidget * );
+
+    /*!
+      The close button of a widget's tab was clicked. This signal is
+      only possible after you have called setHoverCloseButton( true ).
+    */
+    void closeRequest( QWidget * );
+
+protected:
+    virtual void mouseDoubleClickEvent( QMouseEvent *e );
+    virtual void mousePressEvent( QMouseEvent * );
+    virtual void dragMoveEvent( QDragMoveEvent * );
+    virtual void dropEvent( QDropEvent * );
+    unsigned int tabBarWidthForMaxChars( uint maxLength );
+#ifndef QT_NO_WHEELEVENT
+    virtual void wheelEvent( QWheelEvent *e );
+#endif
+    virtual void resizeEvent( QResizeEvent * );
+
+protected slots:
+    virtual void receivedDropEvent( int, QDropEvent * );
+    virtual void initiateDrag( int );
+    virtual void contextMenu( int, const QPoint & );
+    virtual void mouseDoubleClick( int );
+    virtual void mouseMiddleClick( int );
+    virtual void closeRequest( int );
+#ifndef QT_NO_WHEELEVENT
+    virtual void wheelDelta( int );
+#endif
+
+private:
+    bool isEmptyTabbarSpace( const QPoint & )  const;
+    void resizeTabs( int changedTabIndex = -1 );
+    void updateTab( int index );
+
+    KTabWidgetPrivate *d;
+};
+
+#endif