class KitTabBar Tab bar with side tab support. More... Definition #include <tabbar.h> Inherits QWidget (qt) [public ] List of all Methods

Annotated List Files Globals Hierarchy Index

Public Types

• enum Position { Left, Right, Top, Bottom }
• enum TabShape { Rounded, Triangular }
• enum TabSize { Normal, Thin }

Public Methods

•  KitTabBar ( KitTabBar::Position pos = KitTabBar::Top, QWidget * parent = 0, const char * name = 0 )
•  ~KitTabBar ()
• int  addTab ( const QString & text )
• int  addTab ( const QIconSet & icon, const QString & text = QString::null )
• int  insertTab ( const QString & text, int index = -1 )
• int  insertTab ( const QIconSet & icon, const QString & text = QString::null, int index = -1 )
• int  insertTab ( QTab * tab, int index = -1 )
• void  removeTab ( int id )
• void  removeTab ( QTab * tab )
• int  currentTab ()
• void  setCurrentTab ( int id )
• void  setCurrentTab ( QTab * tab )
• void  setTabEnabled ( int id, bool enabled )
• void  setTabEnabled ( QTab * tab, bool enabled )
• void  setTabIconSet ( int id, const QIconSet & icon )
• void  setTabLabel ( int id, const QString & text )
• KitTabBar::Position  position ()
• void  setPosition ( KitTabBar::Position pos )
• Qt::Orientation  orientation ()
• void  setActionMenu ( KActionMenu * menu )
• void  setPopupMenu ( KPopupMenu * menu )
• QTab *  menuTab ()
• bool  allowToggle ()
• void  setAllowToggle ( bool toggle )
• bool  autoSelect ()
• void  setAutoSelect ( bool select )
• KitTabBar::TabShape  tabShape () const
• void  setTabShape ( TabShape shape )
• KitTabBar::TabSize  tabSize () const
• void  setTabSize ( TabSize size )
• QTab *  tab ( int id ) const
• const QString  toolTip ( int id )
• const QString  toolTip ( QTab * tab )
• void  setToolTip ( int id, const QString & tip )
• void  setToolTip ( QTab * tab, const QString & tip )
• void  removeToolTip ( int id )
• void  removeToolTip ( QTab * tab )
• const QString  whatsThis ( int id )
• const QString  whatsThis ( QTab * tab )
• void  setWhatsThis ( int id, const QString & text )
• void  setWhatsThis ( QTab * tab, const QString & text )
• void  removeWhatsThis ( int id )
• void  removeWhatsThis ( QTab * tab )
• int  count ()
• const QPtrList<QTab> *  tabList ()

Signals

• void  selected ( int id )
• void  toggled ( int id, bool selected )
• void  rmbClicked ( int id )
• void  rmbClicked ( QTab * tab )

Protected Methods

• QSize  sizeHint () const
• QSize  minimumSizeHint () const
• void  fontChange ( const QFont & )
• void  paintEvent ( QPaintEvent * )
• void  resizeEvent ( QResizeEvent * )
• void  styleChange ( QStyle & )

Detailed Description

KitTabBar is a full function Tabbar similar to QTabBar but has additional functionality. Additional features include side tabs, tab sizing, context menu support, and QWhatsThis support.

The position of the tab bar

The shape of the tabs

The size of the tabs

Constructor

Destructor

Adds a tab to the bar.

Parameters:

text	the text of the tab

Returns: the id of the tab

Same as above but with an icon.

Parameters:

icon	the icon of the tab
text	the text of the tab

Returns: the id of the tab

Adds a tab to the bar at the index specified.

Parameters:

text	the text of the tab
index	the index of the tab placement

Returns: the id of the tab

Same as above but with an icon.

Parameters:

icon	the icon of the tab
text	the text of the tab
index	the index of the tab placement

Returns: the id of the tab

Same as above but with a pointer to an existing tab. The tab may or may not already have an icon and text.

Parameters:

tab	the pointer to the tab
index	the index of the tab placement

Returns: the id of the tab

Removes the tab from the bar. If the tab is the currently selected tab the next available tab is set as selected.

Parameters:

id	the id of the tab

Same as above

Parameters:

tab	the pointer to the tab

Returns: the id of the currently selected tab

Sets the tab with id as selected

Parameters:

id	the id of the tab

Same as above

Parameters:

tab	the pointer to the tab

Set a tab as enabled or disabled. Use this method instead of using the tab pointer. Using the tab pointer directly has unpredictable results. Disabling the currently selected tab causes the next available enabled tab to be set as selected.

Parameters:

id	the id of the tab
enabled	toggle the tab as enabled/disabled

Same as above

Parameters:

tab	the pointer to the tab
enabled	toggle the tab as enabled/disabled

Sets the tab icon

Parameters:

id	the id of the tab
icon	the iconset for the tab icon

Sets the tab label

Parameters:

id	the id of the tab
text	the text for the tab label

Returns: the current bar position

Sets the tab bar position (Left, Right, Top, Bottom)

Parameters:

pos	the position of the tab bar

Returns: the bar orientation ( Horizontal or Vertical )

Sets the menu for a right click on the tab. This menu superceeds the popup menu if set.

Parameters:

menu	KActionMenu pointer

Sets the menu for a right click on the tab. This menu is superceeded by the action menu if set.

Parameters:

menu	KPopupMenu pointer

Use this to identify the tab that was right clicked.

Returns: the pointer to the tab that was right clicked

Returns: the current toggle mode

Sets the tab toggle mode. You can unselect a tab if set to true. Toggling is off by default.

Parameters:

toggle

allows tab toggling

Returns: the current auto-select mode

Sets the auto-select mode. This will disable automatic selection of tabs when the currently selected tab is removed or disabled. Auto-select is on by default.

Parameters:

auto	the auto-select mode

[const]

Returns: the shape of the tabs

Sets the shape of the tabs

Parameters:

tab

shape

[const]

Returns: the size of the tabs

Sets the size of the tabs

Parameters:

size

tab size

[const]

Parameters:

id	the id of the tab

Returns: a pointer to the tab

Parameters:

id	the id of the tab

Returns: the tooltip text for the tab

Parameters:

tab	the pointer to the tab

Returns: the tooltip text for the tab

Sets the text for the tab tooltip.

Parameters:

id	the id of the tab
tip	the tooltip text for the tab

Sets the text for the tab tooltip.

Parameters:

tab	the pointer to the tab
tip	the tooltip text for the tab

Removes the tooltip from the tab.

Parameters:

id	the id of the tab

Removes the tooltip from the tab.

Parameters:

tab	the pointer to the tab

Parameters:

id	the id of the tab

Returns: the 'whats this' text for the tab

Parameters:

tab	the pointer to the tab

Returns: the 'whats this' text for the tab

Sets the 'whats this' text for the tab.

Parameters:

id	the id of the tab
text	the 'whats this' text for the tab

Sets the 'whats this' text for the tab.

Parameters:

tab	the pointer to the tab
text	the 'whats this' text for the tab

Removes the 'whats this' from the tab.

Parameters:

id	the id of the tab

Removes the 'whats this' from the tab.

Parameters:

tab	the pointer to the tab

Returns: the number of tabs in the bar

Returns: the pointer list of tabs in the bar

[signal]

This is emitted only when the tab is first selected, not when toggled off.

Returns: the id of the tab selected

[signal]

Returns: the tab id and the selection status

[signal]

This is emitted previous to the menu popup. Use this for custom right click processing. Menu's will popup only if set.

Returns: the id of the tab that was right clicked.

[signal]

Same as above but provides the tab pointer.

Returns: the pointer to the tab that was right clicked.

[protected const]

[protected const]

[protected]

Reimplemented from QWidget.

[protected]

[protected]

[protected]

Reimplemented from QWidget.

• Author: Bruce Hunt SuppCast@users.sourceforge.net
• Generated: bhunt on Lurch on Sun Nov 24 02:45:27 2002, using kdoc 2.0a54.