You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdelibs/kdeui/ktabwidget.h

295 lines
8.5 KiB

/* 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