 |
Qt 4.8
|
|
Qt 4.8
|
The QTabBar class provides a tab bar, e.g. More...
#include <qtabbar.h>
Public Types | |
| enum | ButtonPosition { LeftSide, RightSide } |
| This enum type lists the location of the widget on a tab. More... | |
| enum | SelectionBehavior { SelectLeftTab, SelectRightTab, SelectPreviousTab } |
| This enum type lists the behavior of QTabBar when a tab is removed and the tab being removed is also the current tab. More... | |
| enum | Shape { RoundedNorth, RoundedSouth, RoundedWest, RoundedEast, TriangularNorth, TriangularSouth, TriangularWest, TriangularEast } |
| This enum type lists the built-in shapes supported by QTabBar. More... | |
 Public Types inherited from QWidget | |
| enum | RenderFlag { DrawWindowBackground = 0x1, DrawChildren = 0x2, IgnoreMask = 0x4 } |
| This enum describes how to render the widget when calling QWidget::render(). More... | |
| Public Types inherited from QPaintDevice | |
| enum | PaintDeviceMetric { PdmWidth = 1, PdmHeight, PdmWidthMM, PdmHeightMM, PdmNumColors, PdmDepth, PdmDpiX, PdmDpiY, PdmPhysicalDpiX, PdmPhysicalDpiY } |
Public Slots | |
| void | setCurrentIndex (int index) |
| Public Slots inherited from QWidget | |
| bool | close () |
| Closes this widget. More... | |
| void | hide () |
| Hides the widget. More... | |
| void | lower () |
| Lowers the widget to the bottom of the parent widget's stack. More... | |
| void | raise () |
| Raises this widget to the top of the parent widget's stack. More... | |
| void | repaint () |
| Repaints the widget directly by calling paintEvent() immediately, unless updates are disabled or the widget is hidden. More... | |
| void | setDisabled (bool) |
| Disables widget input events if disable is true; otherwise enables input events. More... | |
| void | setEnabled (bool) |
| void | setFocus () |
| Gives the keyboard input focus to this widget (or its focus proxy) if this widget or one of its parents is the active window. More... | |
| void | setHidden (bool hidden) |
| Convenience function, equivalent to setVisible(!hidden). More... | |
| QT_MOC_COMPAT void | setShown (bool shown) |
| Use setVisible(shown) instead. More... | |
| void | setStyleSheet (const QString &styleSheet) |
| virtual void | setVisible (bool visible) |
| void | setWindowModified (bool) |
| void | setWindowTitle (const QString &) |
| void | show () |
| Shows the widget and its child widgets. More... | |
| void | showFullScreen () |
| Shows the widget in full-screen mode. More... | |
| void | showMaximized () |
| Shows the widget maximized. More... | |
| void | showMinimized () |
| Shows the widget minimized, as an icon. More... | |
| void | showNormal () |
| Restores the widget after it has been maximized or minimized. More... | |
| void | update () |
| Updates the widget unless updates are disabled or the widget is hidden. More... | |
| Public Slots inherited from QObject | |
| void | deleteLater () |
| Schedules this object for deletion. More... | |
Signals | |
| void | currentChanged (int index) |
| This signal is emitted when the tab bar's current tab changes. More... | |
| void | tabCloseRequested (int index) |
| This signal is emitted when the close button on a tab is clicked. More... | |
| void | tabMoved (int from, int to) |
| This signal is emitted when the tab has moved the tab at index position from to index position to. More... | |
| Signals inherited from QWidget | |
| void | customContextMenuRequested (const QPoint &pos) |
| This signal is emitted when the widget's contextMenuPolicy is Qt::CustomContextMenu, and the user has requested a context menu on the widget. More... | |
| Signals inherited from QObject | |
| void | destroyed (QObject *=0) |
| This signal is emitted immediately before the object obj is destroyed, and can not be blocked. More... | |
Public Functions | |
| int | addTab (const QString &text) |
| Adds a new tab with text text. More... | |
| int | addTab (const QIcon &icon, const QString &text) |
| Adds a new tab with icon icon and text text. More... | |
| int | count () const |
| int | currentIndex () const |
| bool | documentMode () const |
| bool | drawBase () const |
| Qt::TextElideMode | elideMode () const |
| bool | expanding () const |
| QSize | iconSize () const |
| int | insertTab (int index, const QString &text) |
| Inserts a new tab with text text at position index. More... | |
| int | insertTab (int index, const QIcon &icon, const QString &text) |
| This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Inserts a new tab with icon icon and text text at position index. More... | |
| bool | isMovable () const |
| bool | isTabEnabled (int index) const |
| Returns true if the tab at position index is enabled; otherwise returns false. More... | |
| QSize | minimumSizeHint () const |
| void | moveTab (int from, int to) |
| Moves the item at index position from to index position to. More... | |
| QTabBar (QWidget *parent=0) | |
| Creates a new tab bar with the given parent. More... | |
| void | removeTab (int index) |
| Removes the tab at position index. More... | |
| SelectionBehavior | selectionBehaviorOnRemove () const |
| void | setDocumentMode (bool set) |
| void | setDrawBase (bool drawTheBase) |
| void | setElideMode (Qt::TextElideMode) |
| void | setExpanding (bool enabled) |
| void | setIconSize (const QSize &size) |
| void | setMovable (bool movable) |
| void | setSelectionBehaviorOnRemove (SelectionBehavior behavior) |
| void | setShape (Shape shape) |
| void | setTabButton (int index, ButtonPosition position, QWidget *widget) |
| Sets widget on the tab index. More... | |
| void | setTabData (int index, const QVariant &data) |
| Sets the data of the tab at position index to data. More... | |
| void | setTabEnabled (int index, bool) |
| If enabled is true then the tab at position index is enabled; otherwise the item at position index is disabled. More... | |
| void | setTabIcon (int index, const QIcon &icon) |
| Sets the icon of the tab at position index to icon. More... | |
| void | setTabsClosable (bool closable) |
| void | setTabText (int index, const QString &text) |
| Sets the text of the tab at position index to text. More... | |
| void | setTabTextColor (int index, const QColor &color) |
| Sets the color of the text in the tab with the given index to the specified color. More... | |
| void | setTabToolTip (int index, const QString &tip) |
| Sets the tool tip of the tab at position index to tip. More... | |
| void | setTabWhatsThis (int index, const QString &text) |
| Sets the What's This help text of the tab at position index to text. More... | |
| void | setUsesScrollButtons (bool useButtons) |
| Shape | shape () const |
| QSize | sizeHint () const |
| em>Reimplemented Function More... | |
| int | tabAt (const QPoint &pos) const |
| QWidget * | tabButton (int index, ButtonPosition position) const |
| Returns the widget set a tab index and position or 0 if one is not set. More... | |
| QVariant | tabData (int index) const |
| Returns the data of the tab at position index, or a null variant if index is out of range. More... | |
| QIcon | tabIcon (int index) const |
| Returns the icon of the tab at position index, or a null icon if index is out of range. More... | |
| QRect | tabRect (int index) const |
| Returns the visual rectangle of the tab at position index, or a null rectangle if index is out of range. More... | |
| bool | tabsClosable () const |
| QString | tabText (int index) const |
| Returns the text of the tab at position index, or an empty string if index is out of range. More... | |
| QColor | tabTextColor (int index) const |
| Returns the text color of the tab with the given index, or a invalid color if index is out of range. More... | |
| QString | tabToolTip (int index) const |
| Returns the tool tip of the tab at position index, or an empty string if index is out of range. More... | |
| QString | tabWhatsThis (int index) const |
| Returns the What's This help text of the tab at position index, or an empty string if index is out of range. More... | |
| bool | usesScrollButtons () const |
| ~QTabBar () | |
| Destroys the tab bar. More... | |
| Public Functions inherited from QWidget | |
| bool | acceptDrops () const |
| QString | accessibleDescription () const |
| QString | accessibleName () const |
| QList< QAction * > | actions () const |
| Returns the (possibly empty) list of this widget's actions. More... | |
| void | activateWindow () |
| Sets the top-level widget containing this widget to be the active window. More... | |
| void | addAction (QAction *action) |
| Appends the action action to this widget's list of actions. More... | |
| void | addActions (QList< QAction *> actions) |
| Appends the actions actions to this widget's list of actions. More... | |
| void | adjustSize () |
| Adjusts the size of the widget to fit its contents. More... | |
| bool | autoFillBackground () const |
| QPalette::ColorRole | backgroundRole () const |
| Returns the background role of the widget. More... | |
| QSize | baseSize () const |
| QWidget * | childAt (int x, int y) const |
| Returns the visible child widget at the position ({x}, {y}) in the widget's coordinate system. More... | |
| QWidget * | childAt (const QPoint &p) const |
| Returns the visible child widget at point p in the widget's own coordinate system. More... | |
| QRect | childrenRect () const |
| QRegion | childrenRegion () const |
| void | clearFocus () |
| Takes keyboard input focus from the widget. More... | |
| void | clearMask () |
| Removes any mask set by setMask(). More... | |
| QMargins | contentsMargins () const |
| The contentsMargins function returns the widget's contents margins. More... | |
| QRect | contentsRect () const |
| Returns the area inside the widget's margins. More... | |
| Qt::ContextMenuPolicy | contextMenuPolicy () const |
| void | createWinId () |
| QCursor | cursor () const |
| int | devType () const |
| WId | effectiveWinId () const |
| Returns the effective window system identifier of the widget, i. More... | |
| void | ensurePolished () const |
| Ensures that the widget has been polished by QStyle (i.e., has a proper font and palette). More... | |
| Qt::FocusPolicy | focusPolicy () const |
| QWidget * | focusProxy () const |
| Returns the focus proxy, or 0 if there is no focus proxy. More... | |
| QWidget * | focusWidget () const |
| Returns the last child of this widget that setFocus had been called on. More... | |
| const QFont & | font () const |
| QFontInfo | fontInfo () const |
| Returns the font info for the widget's current font. More... | |
| QFontMetrics | fontMetrics () const |
| Returns the font metrics for the widget's current font. More... | |
| QPalette::ColorRole | foregroundRole () const |
| Returns the foreground role. More... | |
| QRect | frameGeometry () const |
| QSize | frameSize () const |
| const QRect & | geometry () const |
| void | getContentsMargins (int *left, int *top, int *right, int *bottom) const |
| Returns the widget's contents margins for left, top, right, and bottom. More... | |
| HDC | getDC () const |
| Returns the window system handle of the widget, for low-level access. More... | |
| void | grabGesture (Qt::GestureType type, Qt::GestureFlags flags=Qt::GestureFlags()) |
| Subscribes the widget to a given gesture with specific flags. More... | |
| void | grabKeyboard () |
| Grabs the keyboard input. More... | |
| void | grabMouse () |
| Grabs the mouse input. More... | |
| void | grabMouse (const QCursor &) |
| int | grabShortcut (const QKeySequence &key, Qt::ShortcutContext context=Qt::WindowShortcut) |
| Adds a shortcut to Qt's shortcut system that watches for the given key sequence in the given context. More... | |
| QGraphicsEffect * | graphicsEffect () const |
| The graphicsEffect function returns a pointer to the widget's graphics effect. More... | |
| QGraphicsProxyWidget * | graphicsProxyWidget () const |
| Returns the proxy widget for the corresponding embedded widget in a graphics view; otherwise returns 0. More... | |
| bool | hasFocus () const |
| bool | hasMouseTracking () const |
| int | height () const |
| virtual int | heightForWidth (int) const |
| Returns the preferred height for this widget, given the width w. More... | |
| QInputContext * | inputContext () |
| This function returns the QInputContext for this widget. More... | |
| Qt::InputMethodHints | inputMethodHints () const |
| virtual QVariant | inputMethodQuery (Qt::InputMethodQuery) const |
| This method is only relevant for input widgets. More... | |
| void | insertAction (QAction *before, QAction *action) |
| Inserts the action action to this widget's list of actions, before the action before. More... | |
| void | insertActions (QAction *before, QList< QAction *> actions) |
| Inserts the actions actions to this widget's list of actions, before the action before. More... | |
| WId | internalWinId () const |
| Returns the window system identifier of the widget, or 0 if the widget is not created yet. More... | |
| bool | isActiveWindow () const |
| bool | isAncestorOf (const QWidget *child) const |
| Returns true if this widget is a parent, (or grandparent and so on to any level), of the given child, and both widgets are within the same window; otherwise returns false. More... | |
| bool | isEnabled () const |
| bool | isEnabledTo (QWidget *) const |
| Returns true if this widget would become enabled if ancestor is enabled; otherwise returns false. More... | |
| bool | isEnabledToTLW () const |
| This function is deprecated. More... | |
| bool | isFullScreen () const |
| bool | isHidden () const |
| Returns true if the widget is hidden, otherwise returns false. More... | |
| bool | isLeftToRight () const |
| bool | isMaximized () const |
| bool | isMinimized () const |
| bool | isModal () const |
| bool | isRightToLeft () const |
| bool | isTopLevel () const |
| Use isWindow() instead. More... | |
| bool | isVisible () const |
| bool | isVisibleTo (QWidget *) const |
| Returns true if this widget would become visible if ancestor is shown; otherwise returns false. More... | |
| bool | isWindow () const |
| Returns true if the widget is an independent window, otherwise returns false. More... | |
| bool | isWindowModified () const |
| QLayout * | layout () const |
| Returns the layout manager that is installed on this widget, or 0 if no layout manager is installed. More... | |
| Qt::LayoutDirection | layoutDirection () const |
| QLocale | locale () const |
| Qt::HANDLE | macCGHandle () const |
| Returns the CoreGraphics handle of the widget. More... | |
| Qt::HANDLE | macQDHandle () const |
| Returns the QuickDraw handle of the widget. More... | |
| QPoint | mapFrom (QWidget *, const QPoint &) const |
| Translates the widget coordinate pos from the coordinate system of parent to this widget's coordinate system. More... | |
| QPoint | mapFromGlobal (const QPoint &) const |
| Translates the global screen coordinate pos to widget coordinates. More... | |
| QPoint | mapFromParent (const QPoint &) const |
| Translates the parent widget coordinate pos to widget coordinates. More... | |
| QPoint | mapTo (QWidget *, const QPoint &) const |
| Translates the widget coordinate pos to the coordinate system of parent. More... | |
| QPoint | mapToGlobal (const QPoint &) const |
| Translates the widget coordinate pos to global screen coordinates. More... | |
| QPoint | mapToParent (const QPoint &) const |
| Translates the widget coordinate pos to a coordinate in the parent widget. More... | |
| QRegion | mask () const |
| Returns the mask currently set on a widget. More... | |
| int | maximumHeight () const |
| QSize | maximumSize () const |
| int | maximumWidth () const |
| int | minimumHeight () const |
| QSize | minimumSize () const |
| int | minimumWidth () const |
| void | move (int x, int y) |
| This corresponds to move(QPoint(x, y)). More... | |
| void | move (const QPoint &) |
| QWidget * | nativeParentWidget () const |
| Returns the native parent for this widget, i. More... | |
| QWidget * | nextInFocusChain () const |
| Returns the next widget in this widget's focus chain. More... | |
| QRect | normalGeometry () const |
| void | overrideWindowFlags (Qt::WindowFlags type) |
| Sets the window flags for the widget to flags, without telling the window system. More... | |
| void | overrideWindowState (Qt::WindowStates state) |
| QPaintEngine * | paintEngine () const |
| Returns the widget's paint engine. More... | |
| const QPalette & | palette () const |
| QWidget * | parentWidget () const |
| Returns the parent of this widget, or 0 if it does not have any parent widget. More... | |
| QPoint | pos () const |
| QWidget * | previousInFocusChain () const |
| The previousInFocusChain function returns the previous widget in this widget's focus chain. More... | |
| QWidget (QWidget *parent=0, Qt::WindowFlags f=0) | |
| Constructs a widget which is a child of parent, with widget flags set to f. More... | |
| QRect | rect () const |
| void | releaseDC (HDC) const |
| Releases the HDC hdc acquired by a previous call to getDC(). More... | |
| void | releaseKeyboard () |
| Releases the keyboard grab. More... | |
| void | releaseMouse () |
| Releases the mouse grab. More... | |
| void | releaseShortcut (int id) |
| Removes the shortcut with the given id from Qt's shortcut system. More... | |
| void | removeAction (QAction *action) |
| Removes the action action from this widget's list of actions. More... | |
| void | render (QPaintDevice *target, const QPoint &targetOffset=QPoint(), const QRegion &sourceRegion=QRegion(), RenderFlags renderFlags=RenderFlags(DrawWindowBackground|DrawChildren)) |
| Renders the sourceRegion of this widget into the target using renderFlags to determine how to render. More... | |
| void | render (QPainter *painter, const QPoint &targetOffset=QPoint(), const QRegion &sourceRegion=QRegion(), RenderFlags renderFlags=RenderFlags(DrawWindowBackground|DrawChildren)) |
| Renders the widget into the painter's QPainter::device(). More... | |
| void | repaint (int x, int y, int w, int h) |
| This version repaints a rectangle (x, y, w, h) inside the widget. More... | |
| void | repaint (const QRect &) |
| This version repaints a rectangle rect inside the widget. More... | |
| void | repaint (const QRegion &) |
| This version repaints a region rgn inside the widget. More... | |
| void | resize (int w, int h) |
| This corresponds to resize(QSize(w, h)). More... | |
| void | resize (const QSize &) |
| bool | restoreGeometry (const QByteArray &geometry) |
| Restores the geometry and state top-level widgets stored in the byte array geometry. More... | |
| QByteArray | saveGeometry () const |
| Saves the current geometry and state for top-level widgets. More... | |
| void | scroll (int dx, int dy) |
| Scrolls the widget including its children dx pixels to the right and dy downward. More... | |
| void | scroll (int dx, int dy, const QRect &) |
| This version only scrolls r and does not move the children of the widget. More... | |
| void | setAcceptDrops (bool on) |
| void | setAccessibleDescription (const QString &description) |
| void | setAccessibleName (const QString &name) |
| void | setAttribute (Qt::WidgetAttribute, bool on=true) |
| Sets the attribute attribute on this widget if on is true; otherwise clears the attribute. More... | |
| void | setAutoFillBackground (bool enabled) |
| void | setBackgroundRole (QPalette::ColorRole) |
| Sets the background role of the widget to role. More... | |
| void | setBaseSize (const QSize &) |
| void | setBaseSize (int basew, int baseh) |
| This corresponds to setBaseSize(QSize(basew, baseh)). More... | |
| void | setContentsMargins (int left, int top, int right, int bottom) |
| Sets the margins around the contents of the widget to have the sizes left, top, right, and bottom. More... | |
| void | setContentsMargins (const QMargins &margins) |
| The setContentsMargins function sets the margins around the widget's contents. More... | |
| void | setContextMenuPolicy (Qt::ContextMenuPolicy policy) |
| void | setCursor (const QCursor &) |
| void | setFixedHeight (int h) |
| Sets both the minimum and maximum heights of the widget to h without changing the widths. More... | |
| void | setFixedSize (const QSize &) |
| Sets both the minimum and maximum sizes of the widget to s, thereby preventing it from ever growing or shrinking. More... | |
| void | setFixedSize (int w, int h) |
| Sets the width of the widget to w and the height to h. More... | |
| void | setFixedWidth (int w) |
| Sets both the minimum and maximum width of the widget to w without changing the heights. More... | |
| void | setFocus (Qt::FocusReason reason) |
| Gives the keyboard input focus to this widget (or its focus proxy) if this widget or one of its parents is the active window. More... | |
| void | setFocusPolicy (Qt::FocusPolicy policy) |
| void | setFocusProxy (QWidget *) |
| Sets the widget's focus proxy to widget w. More... | |
| void | setFont (const QFont &) |
| Use the single-argument overload instead. More... | |
| void | setForegroundRole (QPalette::ColorRole) |
| Sets the foreground role of the widget to role. More... | |
| void | setGeometry (int x, int y, int w, int h) |
| This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.This corresponds to setGeometry(QRect(x, y, w, h)). More... | |
| void | setGeometry (const QRect &) |
| void | setGraphicsEffect (QGraphicsEffect *effect) |
| The setGraphicsEffect function is for setting the widget's graphics effect. More... | |
| void | setInputContext (QInputContext *) |
| This function sets the input context context on this widget. More... | |
| void | setInputMethodHints (Qt::InputMethodHints hints) |
| void | setLayout (QLayout *) |
| Sets the layout manager for this widget to layout. More... | |
| void | setLayoutDirection (Qt::LayoutDirection direction) |
| void | setLocale (const QLocale &locale) |
| void | setMask (const QBitmap &) |
| Causes only the pixels of the widget for which bitmap has a corresponding 1 bit to be visible. More... | |
| void | setMask (const QRegion &) |
| Causes only the parts of the widget which overlap region to be visible. More... | |
| void | setMaximumHeight (int maxh) |
| void | setMaximumSize (const QSize &) |
| void | setMaximumSize (int maxw, int maxh) |
| This function corresponds to setMaximumSize(QSize(maxw, maxh)). More... | |
| void | setMaximumWidth (int maxw) |
| void | setMinimumHeight (int minh) |
| void | setMinimumSize (const QSize &) |
| void | setMinimumSize (int minw, int minh) |
| This function corresponds to setMinimumSize(QSize(minw, minh)). More... | |
| void | setMinimumWidth (int minw) |
| void | setMouseTracking (bool enable) |
| void | setPalette (const QPalette &) |
| Use the single-argument overload instead. More... | |
| void | setParent (QWidget *parent) |
| Sets the parent of the widget to parent, and resets the window flags. More... | |
| void | setParent (QWidget *parent, Qt::WindowFlags f) |
| This function also takes widget flags, f as an argument. More... | |
| void | setShortcutAutoRepeat (int id, bool enable=true) |
| If enable is true, auto repeat of the shortcut with the given id is enabled; otherwise it is disabled. More... | |
| void | setShortcutEnabled (int id, bool enable=true) |
| If enable is true, the shortcut with the given id is enabled; otherwise the shortcut is disabled. More... | |
| void | setSizeIncrement (const QSize &) |
| void | setSizeIncrement (int w, int h) |
| Sets the x (width) size increment to w and the y (height) size increment to h. More... | |
| void | setSizePolicy (QSizePolicy) |
| void | setSizePolicy (QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical) |
| Sets the size policy of the widget to horizontal and vertical, with standard stretch and no height-for-width. More... | |
| void | setStatusTip (const QString &) |
| void | setStyle (QStyle *) |
| Sets the widget's GUI style to style. More... | |
| void | setToolTip (const QString &) |
| void | setUpdatesEnabled (bool enable) |
| void | setupUi (QWidget *widget) |
| Sets up the user interface for the specified widget. More... | |
| void | setWhatsThis (const QString &) |
| void | setWindowFilePath (const QString &filePath) |
| void | setWindowFlags (Qt::WindowFlags type) |
| void | setWindowIcon (const QIcon &icon) |
| void | setWindowIconText (const QString &) |
| void | setWindowModality (Qt::WindowModality windowModality) |
| void | setWindowOpacity (qreal level) |
| void | setWindowRole (const QString &) |
| Sets the window's role to role. More... | |
| void | setWindowState (Qt::WindowStates state) |
| Sets the window state to windowState. More... | |
| void | setWindowSurface (QWindowSurface *surface) |
| Sets the window surface to be the surface specified. More... | |
| QSize | size () const |
| QSize | sizeIncrement () const |
| QSizePolicy | sizePolicy () const |
| void | stackUnder (QWidget *) |
| Places the widget under w in the parent widget's stack. More... | |
| QString | statusTip () const |
| QStyle * | style () const |
| QString | styleSheet () const |
| bool | testAttribute (Qt::WidgetAttribute) const |
| Returns true if attribute attribute is set on this widget; otherwise returns false. More... | |
| QString | toolTip () const |
| QWidget * | topLevelWidget () const |
| bool | underMouse () const |
| Returns true if the widget is under the mouse cursor; otherwise returns false. More... | |
| void | ungrabGesture (Qt::GestureType type) |
| Unsubscribes the widget from a given gesture type. More... | |
| void | unsetCursor () |
| void | unsetLayoutDirection () |
| void | unsetLocale () |
| void | update (int x, int y, int w, int h) |
| This version updates a rectangle (x, y, w, h) inside the widget. More... | |
| void | update (const QRect &) |
| This version updates a rectangle rect inside the widget. More... | |
| void | update (const QRegion &) |
| This version repaints a region rgn inside the widget. More... | |
| void | updateGeometry () |
| Notifies the layout system that this widget has changed and may need to change geometry. More... | |
| bool | updatesEnabled () const |
| QRegion | visibleRegion () const |
| Returns the unobscured region where paint events can occur. More... | |
| QString | whatsThis () const |
| int | width () const |
| QWidget * | window () const |
| Returns the window for this widget, i.e. More... | |
| QString | windowFilePath () const |
| Qt::WindowFlags | windowFlags () const |
| Window flags are a combination of a type (e. More... | |
| QIcon | windowIcon () const |
| QString | windowIconText () const |
| Qt::WindowModality | windowModality () const |
| qreal | windowOpacity () const |
| QString | windowRole () const |
| Returns the window's role, or an empty string. More... | |
| Qt::WindowStates | windowState () const |
| Returns the current window state. More... | |
| QWindowSurface * | windowSurface () const |
| Returns the QWindowSurface this widget will be drawn into. More... | |
| QString | windowTitle () const |
| Qt::WindowType | windowType () const |
| Returns the window type of this widget. More... | |
| WId | winId () const |
| Returns the window system identifier of the widget. More... | |
| int | x () const |
| const QX11Info & | x11Info () const |
| Returns information about the configuration of the X display used to display the widget. More... | |
| Qt::HANDLE | x11PictureHandle () const |
| Returns the X11 Picture handle of the widget for XRender support. More... | |
| int | y () const |
| ~QWidget () | |
| Destroys the widget. More... | |
| Public Functions inherited from QObject | |
| bool | blockSignals (bool b) |
| If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). More... | |
| const QObjectList & | children () const |
| Returns a list of child objects. More... | |
| bool | connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const |
| bool | disconnect (const char *signal=0, const QObject *receiver=0, const char *member=0) |
| bool | disconnect (const QObject *receiver, const char *member=0) |
| void | dumpObjectInfo () |
| Dumps information about signal connections, etc. More... | |
| void | dumpObjectTree () |
| Dumps a tree of children to the debug output. More... | |
| QList< QByteArray > | dynamicPropertyNames () const |
| Returns the names of all properties that were dynamically added to the object using setProperty(). More... | |
| virtual bool | eventFilter (QObject *, QEvent *) |
| Filters events if this object has been installed as an event filter for the watched object. More... | |
| template<typename T > | |
| T | findChild (const QString &aName=QString()) const |
| Returns the child of this object that can be cast into type T and that is called name, or 0 if there is no such object. More... | |
| template<typename T > | |
| QList< T > | findChildren (const QString &aName=QString()) const |
| Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. More... | |
| template<typename T > | |
| QList< T > | findChildren (const QRegExp &re) const |
| bool | inherits (const char *classname) const |
| Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false. More... | |
| void | installEventFilter (QObject *) |
| Installs an event filter filterObj on this object. More... | |
| bool | isWidgetType () const |
| Returns true if the object is a widget; otherwise returns false. More... | |
| void | killTimer (int id) |
| Kills the timer with timer identifier, id. More... | |
| virtual const QMetaObject * | metaObject () const |
| Returns a pointer to the meta-object of this object. More... | |
| void | moveToThread (QThread *thread) |
| Changes the thread affinity for this object and its children. More... | |
| QString | objectName () const |
| QObject * | parent () const |
| Returns a pointer to the parent object. More... | |
| QVariant | property (const char *name) const |
| Returns the value of the object's name property. More... | |
| Q_INVOKABLE | QObject (QObject *parent=0) |
| Constructs an object with parent object parent. More... | |
| void | removeEventFilter (QObject *) |
| Removes an event filter object obj from this object. More... | |
| void | setObjectName (const QString &name) |
| void | setParent (QObject *) |
| Makes the object a child of parent. More... | |
| bool | setProperty (const char *name, const QVariant &value) |
| Sets the value of the object's name property to value. More... | |
| void | setUserData (uint id, QObjectUserData *data) |
| bool | signalsBlocked () const |
| Returns true if signals are blocked; otherwise returns false. More... | |
| int | startTimer (int interval) |
| Starts a timer and returns a timer identifier, or returns zero if it could not start a timer. More... | |
| QThread * | thread () const |
| Returns the thread in which the object lives. More... | |
| QObjectUserData * | userData (uint id) const |
| virtual | ~QObject () |
| Destroys the object, deleting all its child objects. More... | |
| Public Functions inherited from QPaintDevice | |
| int | colorCount () const |
| int | depth () const |
| int | height () const |
| int | heightMM () const |
| int | logicalDpiX () const |
| int | logicalDpiY () const |
| QT_DEPRECATED int | numColors () const |
| bool | paintingActive () const |
| int | physicalDpiX () const |
| int | physicalDpiY () const |
| int | width () const |
| int | widthMM () const |
| virtual | ~QPaintDevice () |
Protected Functions | |
| void | changeEvent (QEvent *) |
| This event handler can be reimplemented to handle state changes. More... | |
| bool | event (QEvent *) |
| em>Reimplemented Function More... | |
| void | hideEvent (QHideEvent *) |
| em>Reimplemented Function More... | |
| void | initStyleOption (QStyleOptionTab *option, int tabIndex) const |
| Initialize option with the values from the tab at tabIndex. More... | |
| void | keyPressEvent (QKeyEvent *) |
| em>Reimplemented Function More... | |
| void | mouseMoveEvent (QMouseEvent *) |
| This event handler, for event event, can be reimplemented in a subclass to receive mouse move events for the widget. More... | |
| void | mousePressEvent (QMouseEvent *) |
| em>Reimplemented Function More... | |
| void | mouseReleaseEvent (QMouseEvent *) |
| em>Reimplemented Function More... | |
| void | paintEvent (QPaintEvent *) |
| This event handler can be reimplemented in a subclass to receive paint events passed in event. More... | |
| void | resizeEvent (QResizeEvent *) |
| em>Reimplemented Function More... | |
| void | showEvent (QShowEvent *) |
| em>Reimplemented Function More... | |
| virtual void | tabInserted (int index) |
| This virtual handler is called after a new tab was added or inserted at position index. More... | |
| virtual void | tabLayoutChange () |
| This virtual handler is called whenever the tab layout changes. More... | |
| virtual void | tabRemoved (int index) |
| This virtual handler is called after a tab was removed from position index. More... | |
| virtual QSize | tabSizeHint (int index) const |
| Returns the size hint for the tab at position index. More... | |
| void | wheelEvent (QWheelEvent *event) |
| This event handler, for event event, can be reimplemented in a subclass to receive wheel events for the widget. More... | |
| Protected Functions inherited from QWidget | |
| virtual void | actionEvent (QActionEvent *) |
| This event handler is called with the given event whenever the widget's actions are changed. More... | |
| virtual void | closeEvent (QCloseEvent *) |
| This event handler is called with the given event when Qt receives a window close request for a top-level widget from the window system. More... | |
| virtual void | contextMenuEvent (QContextMenuEvent *) |
| This event handler, for event event, can be reimplemented in a subclass to receive widget context menu events. More... | |
| void | create (WId=0, bool initializeWindow=true, bool destroyOldWindow=true) |
| Creates a new widget window if window is 0, otherwise sets the widget's window to window. More... | |
| void | destroy (bool destroyWindow=true, bool destroySubWindows=true) |
| Frees up window system resources. More... | |
| virtual void | dragEnterEvent (QDragEnterEvent *) |
| This event handler is called when a drag is in progress and the mouse enters this widget. More... | |
| virtual void | dragLeaveEvent (QDragLeaveEvent *) |
| This event handler is called when a drag is in progress and the mouse leaves this widget. More... | |
| virtual void | dragMoveEvent (QDragMoveEvent *) |
| This event handler is called if a drag is in progress, and when any of the following conditions occur: the cursor enters this widget, the cursor moves within this widget, or a modifier key is pressed on the keyboard while this widget has the focus. More... | |
| virtual void | dropEvent (QDropEvent *) |
| This event handler is called when the drag is dropped on this widget. More... | |
| virtual void | enabledChange (bool) |
| virtual void | enterEvent (QEvent *) |
| This event handler can be reimplemented in a subclass to receive widget enter events which are passed in the event parameter. More... | |
| virtual void | focusInEvent (QFocusEvent *) |
| This event handler can be reimplemented in a subclass to receive keyboard focus events (focus received) for the widget. More... | |
| bool | focusNextChild () |
| Finds a new widget to give the keyboard focus to, as appropriate for Tab, and returns true if it can find a new widget, or false if it can't. More... | |
| virtual bool | focusNextPrevChild (bool next) |
| Finds a new widget to give the keyboard focus to, as appropriate for Tab and Shift+Tab, and returns true if it can find a new widget, or false if it can't. More... | |
| virtual void | focusOutEvent (QFocusEvent *) |
| This event handler can be reimplemented in a subclass to receive keyboard focus events (focus lost) for the widget. More... | |
| bool | focusPreviousChild () |
| Finds a new widget to give the keyboard focus to, as appropriate for Shift+Tab, and returns true if it can find a new widget, or false if it can't. More... | |
| virtual void | fontChange (const QFont &) |
| virtual void | inputMethodEvent (QInputMethodEvent *) |
| This event handler, for event event, can be reimplemented in a subclass to receive Input Method composition events. More... | |
| virtual void | keyReleaseEvent (QKeyEvent *) |
| This event handler, for event event, can be reimplemented in a subclass to receive key release events for the widget. More... | |
| virtual void | languageChange () |
| virtual void | leaveEvent (QEvent *) |
| This event handler can be reimplemented in a subclass to receive widget leave events which are passed in the event parameter. More... | |
| virtual bool | macEvent (EventHandlerCallRef, EventRef) |
| This special event handler can be reimplemented in a subclass to receive native Macintosh events. More... | |
| int | metric (PaintDeviceMetric) const |
| Internal implementation of the virtual QPaintDevice::metric() function. More... | |
| virtual void | mouseDoubleClickEvent (QMouseEvent *) |
| This event handler, for event event, can be reimplemented in a subclass to receive mouse double click events for the widget. More... | |
| virtual void | moveEvent (QMoveEvent *) |
| This event handler can be reimplemented in a subclass to receive widget move events which are passed in the event parameter. More... | |
| virtual void | paletteChange (const QPalette &) |
| QWidget (QWidgetPrivate &d, QWidget *parent, Qt::WindowFlags f) | |
| virtual bool | qwsEvent (QWSEvent *) |
| This special event handler can be reimplemented in a subclass to receive native Qt for Embedded Linux events which are passed in the event parameter. More... | |
| void | resetInputContext () |
| This function can be called on the widget that currently has focus to reset the input method operating on it. More... | |
| virtual void | styleChange (QStyle &) |
| virtual void | tabletEvent (QTabletEvent *) |
| This event handler, for event event, can be reimplemented in a subclass to receive tablet events for the widget. More... | |
| virtual void | windowActivationChange (bool) |
| virtual bool | winEvent (MSG *message, long *result) |
| This special event handler can be reimplemented in a subclass to receive native Windows events which are passed in the message parameter. More... | |
| virtual bool | x11Event (XEvent *) |
| This special event handler can be reimplemented in a subclass to receive native X11 events passed in the event parameter. More... | |
| Protected Functions inherited from QObject | |
| virtual void | childEvent (QChildEvent *) |
| This event handler can be reimplemented in a subclass to receive child events. More... | |
| virtual void | connectNotify (const char *signal) |
| This virtual function is called when something has been connected to signal in this object. More... | |
| virtual void | customEvent (QEvent *) |
| This event handler can be reimplemented in a subclass to receive custom events. More... | |
| virtual void | disconnectNotify (const char *signal) |
| This virtual function is called when something has been disconnected from signal in this object. More... | |
| QObject (QObjectPrivate &dd, QObject *parent=0) | |
| int | receivers (const char *signal) const |
| Returns the number of receivers connected to the signal. More... | |
| QObject * | sender () const |
| Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns 0. More... | |
| int | senderSignalIndex () const |
| virtual void | timerEvent (QTimerEvent *) |
| This event handler can be reimplemented in a subclass to receive timer events for the object. More... | |
| Protected Functions inherited from QPaintDevice | |
| QPaintDevice () | |
Properties | |
| int | count |
| the number of tabs in the tab bar More... | |
| int | currentIndex |
| the index of the tab bar's visible tab More... | |
| bool | documentMode |
| Whether or not the tab bar is rendered in a mode suitable for the main window. More... | |
| bool | drawBase |
| defines whether or not tab bar should draw its base. More... | |
| Qt::TextElideMode | elideMode |
| how to elide text in the tab bar More... | |
| bool | expanding |
| When expanding is true QTabBar will expand the tabs to use the empty space. More... | |
| QSize | iconSize |
| The size for icons in the tab bar. More... | |
| bool | movable |
| This property holds whether the user can move the tabs within the tabbar area. More... | |
| SelectionBehavior | selectionBehaviorOnRemove |
| What tab should be set as current when removeTab is called if the removed tab is also the current tab. More... | |
| Shape | shape |
| the shape of the tabs in the tab bar More... | |
| bool | tabsClosable |
| Whether or not a tab bar should place close buttons on each tab. More... | |
| bool | usesScrollButtons |
| Whether or not a tab bar should use buttons to scroll tabs when it has many tabs. More... | |
Friends | |
| class | QAccessibleTabBar |
Additional Inherited Members | |
| Static Public Functions inherited from QWidget | |
| static QWidget * | find (WId) |
| Returns a pointer to the widget with window identifer/handle id. More... | |
| static QWidget * | keyboardGrabber () |
| Returns the widget that is currently grabbing the keyboard input. More... | |
| static QWidget * | mouseGrabber () |
| Returns the widget that is currently grabbing the mouse input. More... | |
| static void | setTabOrder (QWidget *, QWidget *) |
| Puts the second widget after the first widget in the focus order. More... | |
| Static Public Functions inherited from QObject | |
| static bool | connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection) |
| Creates a connection of the given type from the signal in the sender object to the method in the receiver object. More... | |
| static bool | connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection) |
| static bool | disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member) |
| Disconnects signal in object sender from method in object receiver. More... | |
| static bool | disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member) |
| static uint | registerUserData () |
| static QString | tr (const char *sourceText, const char *comment=0, int n=-1) |
| static QString | trUtf8 (const char *sourceText, const char *comment=0, int n=-1) |
| Static Public Functions inherited from QPaintDevice | |
| static QWSDisplay * | qwsDisplay () |
| Static Public Variables inherited from QObject | |
| static const QMetaObject | staticMetaObject |
| This variable stores the meta-object for the class. More... | |
| Protected Slots inherited from QWidget | |
| void | updateMicroFocus () |
| Updates the widget's micro focus. More... | |
| Protected Variables inherited from QObject | |
| QScopedPointer< QObjectData > | d_ptr |
| Protected Variables inherited from QPaintDevice | |
| ushort | painters |
| Static Protected Variables inherited from QObject | |
| static const QMetaObject | staticQtMetaObject |
| Related Functions inherited from QWidget | |
| QWidgetList | |
| WId | |
| Platform dependent window identifier. More... | |
| Related Functions inherited from QObject | |
| T | qFindChildqFindChildren (const QObject *obj, const QString &name)() |
| QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QString &name)() |
| QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QRegExp ®Exp)() |
| T * | qobject_cast (QObject *object) |
| QObjectList | |
| void * | qt_find_obj_child (QObject *parent, const char *type, const QString &name) |
| Returns a pointer to the object named name that inherits type and with a given parent. More... | |
| Related Functions inherited from QPaintDevice | |
| const Q_GUI_EXPORT QX11Info * | qt_x11Info (const QPaintDevice *pd) |
| Returns the QX11Info structure for the pd paint device. More... | |
The QTabBar class provides a tab bar, e.g.
for use in tabbed dialogs.
QTabBar is straightforward to use; it draws the tabs using one of the predefined shapes, and emits a signal when a tab is selected. It can be subclassed to tailor the look and feel. Qt also provides a ready-made QTabWidget.
Each tab has a tabText(), an optional tabIcon(), an optional tabToolTip(), optional tabWhatsThis() and optional tabData(). The tabs's attributes can be changed with setTabText(), setTabIcon(), setTabToolTip(), setTabWhatsThis and setTabData(). Each tabs can be enabled or disabled individually with setTabEnabled().
Each tab can display text in a distinct color. The current text color for a tab can be found with the tabTextColor() function. Set the text color for a particular tab with setTabTextColor().
Tabs are added using addTab(), or inserted at particular positions using insertTab(). The total number of tabs is given by count(). Tabs can be removed from the tab bar with removeTab(). Combining removeTab() and insertTab() allows you to move tabs to different positions.
The shape property defines the tabs' appearance. The choice of shape is a matter of taste, although tab dialogs (for preferences and similar) invariably use RoundedNorth . Tab controls in windows other than dialogs almost always use either RoundedSouth or TriangularSouth . Many spreadsheets and other tab controls in which all the pages are essentially similar use TriangularSouth , whereas RoundedSouth is used mostly when the pages are different (e.g. a multi-page tool palette). The default in QTabBar is RoundedNorth .
The most important part of QTabBar's API is the currentChanged() signal. This is emitted whenever the current tab changes (even at startup, when the current tab changes from 'none'). There is also a slot, setCurrentIndex(), which can be used to select a tab programmatically. The function currentIndex() returns the index of the current tab, count holds the number of tabs.
QTabBar creates automatic mnemonic keys in the manner of QAbstractButton; e.g. if a tab's label is "\&Graphics", Alt+G becomes a shortcut key for switching to that tab.
The following virtual functions may need to be reimplemented in order to tailor the look and feel or store extra data with each tab:
For subclasses, you might also need the tabRect() functions which returns the visual geometry of a single tab.
Screenshot of a Plastique style tab bar | A tab bar shown in the Plastique widget style. |
Screenshot of a truncated Plastique tab bar | A truncated tab bar shown in the Plastique widget style. |
This enum type lists the location of the widget on a tab.
| Enumerator | |
|---|---|
| LeftSide | |
| RightSide | |
Definition at line 89 of file qtabbar.h.
This enum type lists the behavior of QTabBar when a tab is removed and the tab being removed is also the current tab.
| Enumerator | |
|---|---|
| SelectLeftTab | |
| SelectRightTab | |
| SelectPreviousTab | |
| enum QTabBar::Shape |
This enum type lists the built-in shapes supported by QTabBar.
Treat these as hints as some styles may not render some of the shapes. However, position should be honored.
| Enumerator | |
|---|---|
| RoundedNorth | |
| RoundedSouth | |
| RoundedWest | |
| RoundedEast | |
| TriangularNorth | |
| TriangularSouth | |
| TriangularWest | |
| TriangularEast | |
Definition at line 81 of file qtabbar.h.
|
explicit |
Creates a new tab bar with the given parent.
Definition at line 746 of file qtabbar.cpp.
| QTabBar::~QTabBar | ( | ) |
| int QTabBar::addTab | ( | const QString & | text | ) |
Adds a new tab with text text.
Returns the new tab's index.
Definition at line 819 of file qtabbar.cpp.
Referenced by QMdiAreaPrivate::appendChild(), and QMdiAreaPrivate::setViewMode().
Adds a new tab with icon icon and text text.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Returns the new tab's index.
Definition at line 833 of file qtabbar.cpp.
|
protectedvirtual |
This event handler can be reimplemented to handle state changes.
The state being changed in this event can be retrieved through the event supplied.
Change events include: QEvent::ToolBarChange, QEvent::ActivationChange, QEvent::EnabledChange, QEvent::FontChange, QEvent::StyleChange, QEvent::PaletteChange, QEvent::WindowTitleChange, QEvent::IconTextChange, QEvent::ModifiedChange, QEvent::MouseTrackingChange, QEvent::ParentChange, QEvent::WindowStateChange, QEvent::LanguageChange, QEvent::LocaleChange, QEvent::LayoutDirectionChange.
Reimplemented from QWidget.
Definition at line 2040 of file qtabbar.cpp.
| int QTabBar::count | ( | ) | const |
Referenced by setCurrentIndex(), and setIconSize().
|
signal |
This signal is emitted when the tab bar's current tab changes.
The new current has the given index, or -1 if there isn't a new one (for example, if there are no tab in the QTabBar)
Referenced by QMainWindowLayout::getTabBar(), removeTab(), and setCurrentIndex().
| int QTabBar::currentIndex | ( | ) | const |
| bool QTabBar::documentMode | ( | ) | const |
Referenced by setMovable().
| bool QTabBar::drawBase | ( | ) | const |
Referenced by setDrawBase().
| Qt::TextElideMode QTabBar::elideMode | ( | ) | const |
Referenced by changeEvent(), and QTabBarPrivate::minimumTabSizeHint().
|
protectedvirtual |
em>Reimplemented Function
Reimplemented from QWidget.
Definition at line 1490 of file qtabbar.cpp.
Referenced by QMainWindowTabBar::event().
| bool QTabBar::expanding | ( | ) | const |
Referenced by setSelectionBehaviorOnRemove().
|
protectedvirtual |
| QSize QTabBar::iconSize | ( | ) | const |
Referenced by setCurrentIndex(), and tabSizeHint().
|
protected |
Initialize option with the values from the tab at tabIndex.
This method is useful for subclasses when they need a QStyleOptionTab, QStyleOptionTabV2, or QStyleOptionTabV3 but don't want to fill in all the information themselves. This function will check the version of the QStyleOptionTab and fill in the additional values for a QStyleOptionTabV2 and QStyleOptionTabV3.
Definition at line 130 of file qtabbar.cpp.
Referenced by insertTab(), paintEvent(), and tabSizeHint().
| int QTabBar::insertTab | ( | int | index, |
| const QString & | text | ||
| ) |
Inserts a new tab with text text at position index.
If index is out of range, the new tab is appened. Returns the new tab's index.
Definition at line 843 of file qtabbar.cpp.
Referenced by addTab(), and QDockAreaLayoutInfo::updateTabBar().
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Inserts a new tab with icon icon and text text at position index.
If index is out of range, the new tab is appended. Returns the new tab's index.
If the QTabBar was empty before this function is called, the inserted tab becomes the current tab.
Inserting a new tab at an index less than or equal to the current index will increment the current index, but keep the current tab.
Definition at line 860 of file qtabbar.cpp.
| bool QTabBar::isMovable | ( | ) | const |
| bool QTabBar::isTabEnabled | ( | int | index | ) | const |
Returns true if the tab at position index is enabled; otherwise returns false.
Definition at line 977 of file qtabbar.cpp.
Referenced by QAccessibleTabBar::state().
|
protectedvirtual |
|
virtual |
Reimplemented from QWidget.
Definition at line 1331 of file qtabbar.cpp.
Referenced by QDockAreaLayoutInfo::tabBarMinimumSize().
|
protectedvirtual |
This event handler, for event event, can be reimplemented in a subclass to receive mouse move events for the widget.
If mouse tracking is switched off, mouse move events only occur if a mouse button is pressed while the mouse is being moved. If mouse tracking is switched on, mouse move events occur even if no mouse button is pressed.
QMouseEvent::pos() reports the position of the mouse cursor, relative to this widget. For press and release events, the position is usually the same as the position of the last mouse move event, but it might be different if the user's hand shakes. This is a feature of the underlying window system, not Qt.
If you want to show a tooltip immediately, while the mouse is moving (e.g., to get the mouse coordinates with QMouseEvent::pos() and show them as a tooltip), you must first enable mouse tracking as described above. Then, to ensure that the tooltip is updated immediately, you must call QToolTip::showText() instead of setToolTip() in your implementation of mouseMoveEvent().
Reimplemented from QWidget.
Definition at line 1810 of file qtabbar.cpp.
|
protectedvirtual |
em>Reimplemented Function
Reimplemented from QWidget.
Definition at line 1779 of file qtabbar.cpp.
Referenced by QMdiAreaTabBar::mousePressEvent().
|
protectedvirtual |
| void QTabBar::moveTab | ( | int | from, |
| int | to | ||
| ) |
Moves the item at index position from to index position to.
Definition at line 1672 of file qtabbar.cpp.
|
protectedvirtual |
This event handler can be reimplemented in a subclass to receive paint events passed in event.
A paint event is a request to repaint all or part of a widget. It can happen for one of the following reasons:
Many widgets can simply repaint their entire surface when asked to, but some slow widgets need to optimize by painting only the requested region: QPaintEvent::region(). This speed optimization does not change the result, as painting is clipped to that region during event processing. QListView and QTableView do this, for example.
Qt also tries to speed up painting by merging multiple paint events into one. When update() is called several times or the window system sends several paint events, Qt merges these events into one event with a larger region (see QRegion::united()). The repaint() function does not permit this optimization, so we suggest using update() whenever possible.
When the paint event occurs, the update region has normally been erased, so you are painting on the widget's background.
The background can be set using setBackgroundRole() and setPalette().
Since Qt 4.0, QWidget automatically double-buffers its painting, so there is no need to write double-buffering code in paintEvent() to avoid flicker.
Note for the X11 platform: It is possible to toggle global double buffering by calling qt_x11_set_global_double_buffer(). For example,
Reimplemented from QWidget.
Definition at line 1568 of file qtabbar.cpp.
| void QTabBar::removeTab | ( | int | index | ) |
Removes the tab at position index.
Definition at line 902 of file qtabbar.cpp.
Referenced by QMainWindowLayout::applyState(), QMdiAreaPrivate::updateActiveWindow(), and QDockAreaLayoutInfo::updateTabBar().
|
protectedvirtual |
| SelectionBehavior QTabBar::selectionBehaviorOnRemove | ( | ) | const |
Referenced by setTabsClosable().
|
slot |
Definition at line 1238 of file qtabbar.cpp.
Referenced by QAccessibleTabBar::doAction(), QMdiAreaPrivate::emitWindowActivated(), event(), insertTab(), mousePressEvent(), mouseReleaseEvent(), removeTab(), QDockAreaLayoutInfo::setCurrentTabId(), QAccessibleTabBar::setSelected(), setTabEnabled(), QMdiAreaPrivate::setViewMode(), and showEvent().
| void QTabBar::setDocumentMode | ( | bool | set | ) |
Definition at line 2325 of file qtabbar.cpp.
Referenced by QMainWindowLayout::getTabBar(), QMdiAreaPrivate::refreshTabBar(), QMainWindowLayout::setDocumentMode(), and QMdiAreaPrivate::setViewMode().
| void QTabBar::setDrawBase | ( | bool | drawTheBase | ) |
Definition at line 800 of file qtabbar.cpp.
Referenced by QMainWindowLayout::getTabBar(), QTabWidgetPrivate::init(), and QDockAreaLayoutInfo::updateTabBar().
| void QTabBar::setElideMode | ( | Qt::TextElideMode | mode | ) |
| void QTabBar::setExpanding | ( | bool | enabled | ) |
Definition at line 2271 of file qtabbar.cpp.
Referenced by QMainWindowTabBar::QMainWindowTabBar(), and QTabWidget::setTabBar().
| void QTabBar::setIconSize | ( | const QSize & | size | ) |
Definition at line 1291 of file qtabbar.cpp.
| void QTabBar::setMovable | ( | bool | movable | ) |
Definition at line 2299 of file qtabbar.cpp.
Referenced by QMdiAreaPrivate::refreshTabBar(), QTabWidget::setMovable(), and QMdiAreaPrivate::setViewMode().
| void QTabBar::setSelectionBehaviorOnRemove | ( | QTabBar::SelectionBehavior | behavior | ) |
Definition at line 2246 of file qtabbar.cpp.
| void QTabBar::setShape | ( | Shape | shape | ) |
Definition at line 778 of file qtabbar.cpp.
Referenced by QMdiAreaPrivate::refreshTabBar(), QDockAreaLayoutInfo::setTabBarShape(), QMdiAreaPrivate::setViewMode(), and QDockAreaLayoutInfo::updateTabBar().
| void QTabBar::setTabButton | ( | int | index, |
| ButtonPosition | position, | ||
| QWidget * | widget | ||
| ) |
Sets widget on the tab index.
The widget is placed on the left or right hand side depending upon the position.
Any previously set widget in position is hidden.
The tab bar will take ownership of the widget and so all widgets set here will be deleted by the tab bar when it is destroyed unless you separately reparent the widget after setting some other widget (or 0).
Definition at line 2346 of file qtabbar.cpp.
Referenced by insertTab(), and setTabsClosable().
| void QTabBar::setTabData | ( | int | index, |
| const QVariant & | data | ||
| ) |
Sets the data of the tab at position index to data.
Definition at line 1156 of file qtabbar.cpp.
Referenced by QDockAreaLayoutInfo::updateTabBar().
| void QTabBar::setTabEnabled | ( | int | index, |
| bool | enabled | ||
| ) |
If enabled is true then the tab at position index is enabled; otherwise the item at position index is disabled.
Definition at line 989 of file qtabbar.cpp.
Referenced by QMdiAreaPrivate::_q_currentTabChanged().
| void QTabBar::setTabIcon | ( | int | index, |
| const QIcon & | icon | ||
| ) |
Sets the icon of the tab at position index to icon.
Definition at line 1080 of file qtabbar.cpp.
| void QTabBar::setTabsClosable | ( | bool | closable | ) |
Definition at line 2158 of file qtabbar.cpp.
Referenced by QMdiAreaPrivate::refreshTabBar(), QTabWidget::setTabsClosable(), and QMdiAreaPrivate::setViewMode().
| void QTabBar::setTabText | ( | int | index, |
| const QString & | text | ||
| ) |
Sets the text of the tab at position index to text.
Definition at line 1021 of file qtabbar.cpp.
Referenced by QDockAreaLayoutInfo::updateTabBar().
| void QTabBar::setTabTextColor | ( | int | index, |
| const QColor & | color | ||
| ) |
Sets the color of the text in the tab with the given index to the specified color.
If an invalid color is specified, the tab will use the QTabBar foreground role instead.
Definition at line 1056 of file qtabbar.cpp.
| void QTabBar::setTabToolTip | ( | int | index, |
| const QString & | tip | ||
| ) |
Sets the tool tip of the tab at position index to tip.
Definition at line 1097 of file qtabbar.cpp.
Referenced by QDockAreaLayoutInfo::updateTabBar().
| void QTabBar::setTabWhatsThis | ( | int | index, |
| const QString & | text | ||
| ) |
Sets the What's This help text of the tab at position index to text.
Definition at line 1127 of file qtabbar.cpp.
| void QTabBar::setUsesScrollButtons | ( | bool | useButtons | ) |
Definition at line 2106 of file qtabbar.cpp.
| Shape QTabBar::shape | ( | ) | const |
Referenced by QMainWindowTabBar::event(), setShape(), QTabBarPrivate::slide(), QMdiAreaPrivate::updateTabBarGeometry(), and ~QTabBar().
|
protectedvirtual |
|
virtual |
em>Reimplemented Function
Reimplemented from QWidget.
Definition at line 1317 of file qtabbar.cpp.
Referenced by QMainWindowTabBar::event(), minimumSizeHint(), QDockAreaLayoutInfo::tabBarSizeHint(), and QMdiAreaPrivate::updateTabBarGeometry().
| int QTabBar::tabAt | ( | const QPoint & | position | ) | const |
Definition at line 1203 of file qtabbar.cpp.
Referenced by event(), and mouseMoveEvent().
| QWidget * QTabBar::tabButton | ( | int | index, |
| ButtonPosition | position | ||
| ) | const |
Returns the widget set a tab index and position or 0 if one is not set.
Definition at line 2375 of file qtabbar.cpp.
Referenced by setTabsClosable().
|
signal |
This signal is emitted when the close button on a tab is clicked.
The index is the index that should be removed.
Referenced by QAccessibleTabBar::doAction().
| QVariant QTabBar::tabData | ( | int | index | ) | const |
Returns the data of the tab at position index, or a null variant if index is out of range.
Definition at line 1167 of file qtabbar.cpp.
Referenced by QDockAreaLayoutInfo::currentTabId(), QDockAreaLayoutInfo::setCurrentTabId(), and QDockAreaLayoutInfo::updateTabBar().
| QIcon QTabBar::tabIcon | ( | int | index | ) | const |
Returns the icon of the tab at position index, or a null icon if index is out of range.
Definition at line 1069 of file qtabbar.cpp.
|
protectedvirtual |
This virtual handler is called after a new tab was added or inserted at position index.
Definition at line 1442 of file qtabbar.cpp.
Referenced by insertTab().
|
protectedvirtual |
This virtual handler is called whenever the tab layout changes.
Definition at line 1463 of file qtabbar.cpp.
Referenced by moveTab().
|
signal |
This signal is emitted when the tab has moved the tab at index position from to index position to.
note: QTabWidget will automatically move the page when this signal is emitted from its tab bar.
Referenced by moveTab().
| QRect QTabBar::tabRect | ( | int | index | ) | const |
Returns the visual rectangle of the tab at position index, or a null rectangle if index is out of range.
Definition at line 1179 of file qtabbar.cpp.
Referenced by event(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), paintEvent(), QAccessibleTabBar::rect(), setTabIcon(), setTabTextColor(), and tabAt().
|
protectedvirtual |
This virtual handler is called after a tab was removed from position index.
Definition at line 1453 of file qtabbar.cpp.
Referenced by removeTab().
| bool QTabBar::tabsClosable | ( | ) | const |
Referenced by setUsesScrollButtons().
|
protectedvirtual |
Returns the size hint for the tab at position index.
Definition at line 1388 of file qtabbar.cpp.
| QString QTabBar::tabText | ( | int | index | ) | const |
Returns the text of the tab at position index, or an empty string if index is out of range.
Definition at line 1010 of file qtabbar.cpp.
Referenced by QDockAreaLayoutInfo::updateTabBar().
| QColor QTabBar::tabTextColor | ( | int | index | ) | const |
Returns the text color of the tab with the given index, or a invalid color if index is out of range.
Definition at line 1041 of file qtabbar.cpp.
| QString QTabBar::tabToolTip | ( | int | index | ) | const |
Returns the tool tip of the tab at position index, or an empty string if index is out of range.
Definition at line 1108 of file qtabbar.cpp.
| QString QTabBar::tabWhatsThis | ( | int | index | ) | const |
Returns the What's This help text of the tab at position index, or an empty string if index is out of range.
Definition at line 1143 of file qtabbar.cpp.
| bool QTabBar::usesScrollButtons | ( | ) | const |
Referenced by setElideMode().
|
protectedvirtual |
This event handler, for event event, can be reimplemented in a subclass to receive wheel events for the widget.
If you reimplement this handler, it is very important that you ignore() the event if you do not handle it, so that the widget's parent can interpret it.
The default implementation ignores the event.
Reimplemented from QWidget.
Definition at line 2018 of file qtabbar.cpp.
|
friend |
|
private |
the number of tabs in the tab bar
em>Reimplemented Function
Definition at line 66 of file qtabbar.h.
Referenced by QMainWindowLayout::applyState(), QAccessibleTabBar::childCount(), QDockAreaLayoutInfo::setCurrentTabId(), QAccessibleTabBar::state(), QAccessibleTabBar::text(), and QDockAreaLayoutInfo::updateTabBar().
|
private |
the index of the tab bar's visible tab
The current index is -1 if there is no current tab.
Definition at line 65 of file qtabbar.h.
Referenced by QDockAreaLayoutInfo::currentTabId(), QAccessibleTabBar::selection(), and QAccessibleTabBar::state().
|
private |
Whether or not the tab bar is rendered in a mode suitable for the main window.
This property is used as a hint for styles to draw the tabs in a different way then they would normally look in a tab widget. On Mac OS X this will look similar to the tabs in Safari or Leopard's Terminal.app.
Definition at line 75 of file qtabbar.h.
Referenced by QTabBarPrivate::initStyleBaseOption().
|
private |
defines whether or not tab bar should draw its base.
If true then QTabBar draws a base in relation to the styles overlab. Otherwise only the tabs are drawn.
|
private |
how to elide text in the tab bar
This property controls how items are elided when there is not enough space to show them for a given tab bar size.
By default the value is style dependent.
|
private |
When expanding is true QTabBar will expand the tabs to use the empty space.
By default the value is true.
|
private |
The size for icons in the tab bar.
The default value is style-dependent. iconSize is a maximum size; icons that are smaller are not scaled up.
|
private |
This property holds whether the user can move the tabs within the tabbar area.
By default, this property is false;
Definition at line 74 of file qtabbar.h.
Referenced by QTabBarPrivate::moveTabFinished(), and setMovable().
|
private |
What tab should be set as current when removeTab is called if the removed tab is also the current tab.
By default the value is SelectRightTab.
|
private |
the shape of the tabs in the tab bar
Possible values for this property are described by the Shape enum.
Definition at line 64 of file qtabbar.h.
Referenced by QTabBarPrivate::initStyleBaseOption().
|
private |
Whether or not a tab bar should place close buttons on each tab.
When tabsClosable is set to true a close button will appear on the tab on either the left or right hand side depending upon the style. When the button is clicked the tab the signal tabCloseRequested will be emitted.
By default the value is false.
Definition at line 71 of file qtabbar.h.
Referenced by QAccessibleTabBar::actionText(), QTabWidget::setTabPosition(), and QAccessibleTabBar::userActionCount().
|
private |
Whether or not a tab bar should use buttons to scroll tabs when it has many tabs.
When there are too many tabs in a tab bar for its size, the tab bar can either choose to expand its size or to add buttons that allow you to scroll through the tabs.
By default the value is style dependant.