kdeui Library API Documentation

KTabWidget Class Reference

Since:
3.2
More...

#include <ktabwidget.h>

Inheritance diagram for KTabWidget:

QTabWidget List of all members.

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 setTabColor().

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.

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 movedTab(), moveTab(), and setTabColor().

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().

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().

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().

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:
KDE Logo
This file is part of the documentation for kdeui Library Version 3.2.3.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Sun Oct 10 18:55:13 2004 by doxygen 1.3.7 written by Dimitri van Heesch, © 1997-2003