KTabWidget Class Reference

#include <ktabwidget.h>

Inheritance diagram for KTabWidget:

QTabWidget List of all members.

Detailed Description

A widget containing multiple tabs.

Since:
3.2

Definition at line 36 of file ktabwidget.h.


Public Slots

virtual void moveTab (int, int)
virtual void removePage (QWidget *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 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 ()
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
bool tabCloseActivatePrevious () const
bool automaticResizeTabs () const
void setTabBarHidden (bool hide)
bool isTabBarHidden () const
virtual void insertTab (QWidget *, const QString &, int index=-1)
virtual void insertTab (QWidget *child, const QIconSet &iconset, const QString &label, int index=-1)
virtual void insertTab (QWidget *, QTab *, int index=-1)
void changeTab (QWidget *, const QString &)
void changeTab (QWidget *child, const QIconSet &iconset, const QString &label)
QString label (int) const
QString tabLabel (QWidget *) const
void setTabLabel (QWidget *, const QString &)

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)
virtual void wheelDelta (int)

Protected Member Functions

virtual void mouseDoubleClickEvent (QMouseEvent *e)
virtual void mousePressEvent (QMouseEvent *)
virtual void dragMoveEvent (QDragMoveEvent *)
virtual void dropEvent (QDropEvent *)
unsigned int tabBarWidthForMaxChars (uint maxLength)
virtual void wheelEvent (QWheelEvent *e)
virtual void resizeEvent (QResizeEvent *)

Properties

bool tabReorderingEnabled []
bool hoverCloseButton []
bool hoverCloseButtonDelayed []
bool tabCloseActivatePrevious []
bool automaticResizeTabs []

Constructor & Destructor Documentation

KTabWidget::~KTabWidget (  )  [virtual]

Destructor.

Definition at line 74 of file ktabwidget.cpp.


Member Function Documentation

bool KTabWidget::automaticResizeTabs (  )  const

Returns true if calling setTitle() will resize tabs to the width of the tab bar.

Since:
3.4

void KTabWidget::changeTab ( QWidget child,
const QIconSet iconset,
const QString label 
)

Reimplemented for internal reasons.

Reimplemented from QTabWidget.

Definition at line 199 of file ktabwidget.cpp.

void KTabWidget::changeTab ( QWidget ,
const QString  
)

Reimplemented for internal reasons.

Reimplemented from QTabWidget.

Definition at line 187 of file ktabwidget.cpp.

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

void KTabWidget::contextMenu ( QWidget ,
const QPoint  
) [signal]

The right mouse button was pressed over a widget.

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

The right mouse button was pressed over empty space besides 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::initiateDrag ( QWidget  )  [signal]

Request to start a drag operation on the given tab.

void KTabWidget::insertTab ( QWidget ,
QTab ,
int  index = -1 
) [virtual]

Reimplemented for internal reasons.

Reimplemented from QTabWidget.

Definition at line 89 of file ktabwidget.cpp.

void KTabWidget::insertTab ( QWidget child,
const QIconSet iconset,
const QString label,
int  index = -1 
) [virtual]

Reimplemented for internal reasons.

Reimplemented from QTabWidget.

Definition at line 84 of file ktabwidget.cpp.

void KTabWidget::insertTab ( QWidget ,
const QString ,
int  index = -1 
) [virtual]

Reimplemented for internal reasons.

Reimplemented from QTabWidget.

Definition at line 79 of file ktabwidget.cpp.

bool KTabWidget::isTabBarHidden (  )  const

Returns true if the tabbar is hidden.

Since:
3.4

Definition at line 120 of file ktabwidget.cpp.

bool KTabWidget::isTabReorderingEnabled (  )  const

Returns true if tab ordering with the middle mouse button has been enabled.

Definition at line 148 of file ktabwidget.cpp.

QString KTabWidget::label ( int   )  const

Reimplemented for internal reasons.

Definition at line 211 of file ktabwidget.cpp.

void KTabWidget::mouseDoubleClick ( QWidget  )  [signal]

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

void KTabWidget::mouseDoubleClick (  )  [signal]

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

Since:
3.3

void KTabWidget::mouseMiddleClick ( QWidget  )  [signal]

A middle 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::movedTab ( int  ,
int   
) [signal]

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

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 405 of file ktabwidget.cpp.

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::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::removePage ( QWidget w  )  [virtual, slot]

Removes the widget, reimplemented for internal reasons (keeping labels in sync).

Reimplemented from QTabWidget.

Definition at line 440 of file ktabwidget.cpp.

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

If 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

Definition at line 493 of file ktabwidget.cpp.

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 473 of file ktabwidget.cpp.

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 483 of file ktabwidget.cpp.

void KTabWidget::setTabBarHidden ( bool  hide  ) 

If hide is true, the tabbar is hidden along with any corner widgets.

Since:
3.4

Definition at line 104 of file ktabwidget.cpp.

void KTabWidget::setTabCloseActivatePrevious ( bool  previous  )  [slot]

If previous is true, closing the current tab activates the previous active tab instead of the one to the right.

Since:
3.3

Definition at line 153 of file ktabwidget.cpp.

void KTabWidget::setTabColor ( QWidget ,
const QColor color 
)

Set the tab of the given widget to color.

Definition at line 125 of file ktabwidget.cpp.

void KTabWidget::setTabLabel ( QWidget ,
const QString  
)

Reimplemented for internal reasons.

Reimplemented from QTabWidget.

Definition at line 236 of file ktabwidget.cpp.

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 143 of file ktabwidget.cpp.

bool KTabWidget::tabCloseActivatePrevious (  )  const

Returns true if closing the current tab activates the previous actice tab instead of the one to the right.

Since:
3.3

QColor KTabWidget::tabColor ( QWidget  )  const

Returns the tab color for the given widget.

Definition at line 133 of file ktabwidget.cpp.

QString KTabWidget::tabLabel ( QWidget  )  const

Reimplemented for internal reasons.

Definition at line 223 of file ktabwidget.cpp.

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.


The documentation for this class was generated from the following files:
KDE Home | KDE Accessibility Home | Description of Access Keys