KTabWidget Class Reference

Since:: 3.2

#include <ktabwidget.h>

Inheritance diagram for KTabWidget:


Public Slots
virtual void	moveTab (int, int)
void	setTabReorderingEnabled (bool enable)
void	setHoverCloseButton (bool enable)
void	setHoverCloseButtonDelayed (bool delayed)
Signals
void	testCanDecode (const QDragMoveEvent *e, bool &accept)
void	receivedDropEvent (QDropEvent *)
void	receivedDropEvent (QWidget , QDropEvent )
void	initiateDrag (QWidget *)
void	contextMenu (const QPoint &)
void	contextMenu (QWidget *, const QPoint &)
void	movedTab (int, int)
void	mouseDoubleClick (QWidget *)
void	mouseMiddleClick ()
void	mouseMiddleClick (QWidget *)
void	closeRequest (QWidget *)
Public Member Functions
	KTabWidget (QWidget parent=0, const char name=0, WFlags f=0)
virtual	~KTabWidget ()
void	setTabColor (QWidget *, const QColor &color)
QColor	tabColor (QWidget *) const
bool	isTabReorderingEnabled () const
bool	hoverCloseButton () const
bool	hoverCloseButtonDelayed () const
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)
Protected Member Functions
virtual void	mousePressEvent (QMouseEvent *)
virtual void	dragMoveEvent (QDragMoveEvent *)
virtual void	dropEvent (QDropEvent *)
Properties
bool	tabReorderingEnabled
bool	hoverCloseButton
bool	hoverCloseButtonDelayed

Detailed Description

Since:: 3.2

Definition at line 31 of file ktabwidget.h.

Constructor & Destructor Documentation

KTabWidget::~KTabWidget ( ) [virtual]

Destructor.

Definition at line 42 of file ktabwidget.cpp.

Member Function Documentation

void KTabWidget::setTabColor ( QWidget * ,

const QColor & color

)

Set the tab of the given widget to color.
Definition at line 48 of file ktabwidget.cpp.
References QTab::identifier(), setTabColor(), and QTabWidget::tabBar().
Referenced by moveTab(), and setTabColor().

bool KTabWidget::isTabReorderingEnabled ( ) const

Returns true if tab ordering with the middle mouse button has been enabled.
Definition at line 71 of file ktabwidget.cpp.
References QTabWidget::tabBar().

bool KTabWidget::hoverCloseButton ( ) const

Returns true if the close button is shown on tabs when mouse is hovering over them.

bool KTabWidget::hoverCloseButtonDelayed ( ) const

Returns true if the close button is shown on tabs after a delay.

void KTabWidget::moveTab ( int ,

int

) [virtual, slot]

Move a widget's tab from first to second specified index and emit signal movedTab( int, int ) afterwards.
Definition at line 140 of file ktabwidget.cpp.
References QTabWidget::currentPage(), movedTab(), moveTab(), setTabColor(), and QTab::setText().
Referenced by moveTab().

void KTabWidget::setTabReorderingEnabled ( bool enable ) [slot]

If 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.
Definition at line 66 of file ktabwidget.cpp.
References setTabReorderingEnabled(), and QTabWidget::tabBar().
Referenced by setTabReorderingEnabled().

void KTabWidget::setHoverCloseButton ( bool enable ) [slot]

If enable is true, a close button will be shown on mouse hover over tab icons which will emit signal closeRequest( QWidget * ) when pressed.
Definition at line 191 of file ktabwidget.cpp.
References setHoverCloseButton(), and QTabWidget::tabBar().
Referenced by setHoverCloseButton().

void KTabWidget::setHoverCloseButtonDelayed ( bool delayed ) [slot]

If delayed is true, a close button will be shown on mouse hover over tab icons after mouse double click delay else immediately.
Definition at line 201 of file ktabwidget.cpp.
References setHoverCloseButtonDelayed(), and QTabWidget::tabBar().
Referenced by setHoverCloseButtonDelayed().

void KTabWidget::testCanDecode ( const QDragMoveEvent * e,

bool & accept

) [signal]

Connect to this and set accept to true if you can and want to decode the event.

void KTabWidget::receivedDropEvent ( QDropEvent * ) [signal]

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 KTabWidget::receivedDropEvent ( QWidget * ,

QDropEvent *

) [signal]

Received an drop event on given widget's tab. This signal is only possible after testCanDecode and positive accept result.

void KTabWidget::initiateDrag ( QWidget * ) [signal]

Request to start a drag operation on the given tab.

void KTabWidget::contextMenu ( const QPoint & ) [signal]

The right mouse button was pressed over empty space besides tabbar.

void KTabWidget::contextMenu ( QWidget * ,

const QPoint &

) [signal]

The right mouse button was pressed over a widget.

void KTabWidget::movedTab ( int ,

int

) [signal]

A tab was moved from first to second index. This signal is only possible after you have called setTabReorderingEnabled( true ).
Referenced by moveTab().

void KTabWidget::mouseDoubleClick ( QWidget * ) [signal]

A double left mouse button click was performed over the widget.

void KTabWidget::mouseMiddleClick ( ) [signal]

A middle mouse button click was performed over empty space besides tabbar.

void KTabWidget::mouseMiddleClick ( QWidget * ) [signal]

A middle mouse button click was performed over the widget.

void KTabWidget::closeRequest ( QWidget * ) [signal]

The close button of a widget's tab was clicked. This signal is only possible after you have called setHoverCloseButton( true ).

The documentation for this class was generated from the following files:

kdeui Library API Documentation

KTabWidget Class Reference

Public Slots

Signals

Public Member Functions

Protected Slots

Protected Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation