• Skip to content
  • Skip to link menu
KDE 4.2 API Reference
  • KDE API Reference
  • kdelibs
  • Sitemap
  • Contact Us
 

KDEUI

KStyle::TabBar

KStyle::TabBar Struct Reference
[KStyle widget representation]

Describes a tab bar. More...

#include <kstyle.h>

List of all members.


Public Types

enum  LayoutProp {
  TabContentsMargin, TabFocusMargin = TabContentsMargin + MarginInc, TabTextToIconSpace = TabFocusMargin + MarginInc, TabOverlap,
  BaseHeight, BaseOverlap, ScrollButtonWidth
}
enum  Primitive {
  EastText, WestText, NorthTab, EastTab,
  WestTab, SouthTab, BaseFrame, IndicatorTear
}

Detailed Description

Describes a tab bar.

See also:
WT_TabBar

Definition at line 935 of file kstyle.h.


Member Enumeration Documentation

enum KStyle::TabBar::LayoutProp

Each tab is basically built hiearchically out of the following areas:

  1. Content area, one of the following layouts:
    • Icon <- TextToIconSpace -> Text
    • Icon
    • Text
  2. Bevel: LP_TabBar_TabContentsMargin outside of the content area
  3. Focus indicator is placed LP_TabBar_TabFocusMargin inside the bevel.

Note:
The side tabs just have those rotated, bottom tabs have the margins reversed.
See also:
setWidgetLayoutProp()
Enumerator:
TabContentsMargin  (6) margin around the tab contents, used to size the tab
TabFocusMargin  (3) where the tab focus rect is placed, measured from the tab sides (?)
TabTextToIconSpace  (0 ?) space between icon and text if the tab contains both
TabOverlap  (0) Amount of pixels tabs should overlap.

The paint rectangle will be extended to the left for all tabs which are not at the beginning (accordingly extended to the right in RightToLeft mode; extended to the top for East/West tabs).

BaseHeight  (2) the height of the tabBar's base, usually the frame width [sets QStyle::PM_TabBarBaseHeight]

Todo:
is this used for things like I intended TabWidget::ContentsMargin for?
BaseOverlap  (2) the number of pixels the tabs overlap with the base (i.e. tabWidget frame) [sets QStyle::PM_TabBarBaseOverlap]
ScrollButtonWidth  (10) buttons which are shown when there's not enough space for tabs (A ToolButton is used for this) [sets QStyle::PM_TabBarScrollButtonWidth]

Definition at line 950 of file kstyle.h.

enum KStyle::TabBar::Primitive

Relevant elements:

  • Generic::Text for the TabBar labels
  • Generic::FocusIndicator for focused tabs
  • Generic::Icon for icons associated to tabs
  • ToolButton::Panel paints the scroll button (when the tabs don't fit the tab bar).

Enumerator:
EastText  Special rotated text for east tabs.

WestText 
See also:
EastText
NorthTab 
Todo:
say something about triangular shape etc.
EastTab 
WestTab 
SouthTab 
BaseFrame  [implements QStyle::PE_FrameTabBarBase]
IndicatorTear  painted in the left edge of a tabbar when the left tab is scrolled out [implements PE_IndicatorTabTear]

Todo:
KStyle default implementation...?

Definition at line 975 of file kstyle.h.


The documentation for this struct was generated from the following file:
  • kstyle.h

KDEUI

Skip menu "KDEUI"
  • Main Page
  • Modules
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

kdelibs

Skip menu "kdelibs"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • Kate
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • kio
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • Kross
  • KUtils
  • Nepomuk
  • Plasma
  • Solid
  • Sonnet
  • ThreadWeaver
Generated for kdelibs by doxygen 1.5.7
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal