class KDockTabBar

The actual tab bar for dockwidgets (and member of the dockwidget class set). More...

Definition#include <kdocktabctl.h>
InheritsQWidget (kdecore)
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Types

Public Methods

Signals

Protected Methods

Protected Slots


Detailed Description

The actual tab bar for dockwidgets (and member of the dockwidget class set).

This class is covered by its manager, KDockTabCtl. It provides some set/get methods and managment methods like insert, remove, activate for tab widgets.

 KDockTabBar ( QWidget * parent = 0, const char * name = 0 )

Constructs a tab bar widget. The parent and name argument are sent to the QWidget constructor.

KDockTabBar ()

Destructs this.

enum TabPos {TAB_TOP, TAB_RIGHT }

For clearer setting (or asking for) the current tab page position.

void  setTabPos ( TabPos tabpos)

Set the position to tabpos and repaints this.

Parameters:
tabposEither TAB_TOP or TAB_RIGHT, just where you want it to be

int  insertTab ( const QString &label, int id = -1, int index = -1 )

Insert a new empty tab page to the tab bar.

If id is not specified, the tab is simply added. Otherwise it's inserted at the specified position.

Parameters:
labelThe title in the tab page header.
idSuggest an identification number for access operations but it will be shifted to the next free value.
indexThe tab page position (default=-1 means append)

Returns: The new allocated id.

void  setPixmap ( int id, const QPixmap &pix )

Set an icon for the tab page with that id.

Parameters:
idThe identification number of that desired page.
pixThe new pixmap.

void  setToolTip ( int id, const QString &toolTipStr )

Set a tooltip for the tab page with that id.

Parameters:
idThe identification number of that desired page.
toolTipStrThe new tooltip.

void  setTextColor ( int id, const QColor &color )

Set the text colour for the tab page with that id.

Parameters:
idThe identification number of that desired page.
colorThe new text colour.

const QColor&  textColor ( int id )

Retrieve the text colour for the tab page with that id.

Parameters:
idthe identification number of that desired tab page

Returns: the current text colour of that tab page

void  removeTab ( int id)

Removes the tab page with that id.

Parameters:
idThe identification number of that desired page.

int  currentTab ()

Retrieve the current tab page.

Returns: The id of the tab page.

void  setCurrentTab ( int id, bool allowDisable = false )

Set the current tab page to the page with that id.

Parameters:
idThe identification number of that desired page.
allowDisableDisables the tab page.

void  setTabEnabled ( int id, bool e)

Enable or disable the tab page with that id.

bool  isTabEnabled ( int id)

Returns if the tab page with that id is enabled or disabled.

void  setTabCaption ( int id, const QString &caption )

Set the title of the tab page with that id.

Parameters:
idThe identification number of that desired page.
captionA string for the title.

QString  tabCaption ( int id )

Retrieve the title of the tab page with that id.

Parameters:
idthe identification number of that desired page

void  show ()

[virtual]

Calls QWidget::show() and showPage() for the current tab page, additionally.

void  setFont ( const QFont & )

[virtual]

Set the font of this.

void  showTabIcon ( bool )

Show or hide the icons for the tab pages in the header.

bool  isShowTabIcon ()

Returns if the icons for the tab pages are shown in the header.

void  tabSelected ( int id)

[signal]

Signals that a tab page with that id is selected.

Parameters:
idthe identification number of that desired page

void  rightButtonPress ( int id, QPoint )

[signal]

Signals that the right mouse buttons is pressed on the tab page with that @pid.

Parameters:
idThe identification number of that desired page.

void  leftClicked ()

[protected slot]

Does things that should be done if someone has clicked the left mouse button.

void  rightClicked ()

[protected slot]

Does things that should be done if someone has clicked the right mouse button.

void  paintEvent ( QPaintEvent* )

[protected virtual]

Handles paint events for this widgets Reimplemented from QWidget

void  resizeEvent ( QResizeEvent* )

[protected virtual]

Handles resize events for this widgets Reimplemented from QWidget

void  keyPressEvent ( QKeyEvent* )

[protected virtual]

Handles key press events for this widgets Reimplemented from QWidget