Qt 4.8
Public Slots | Signals | Public Functions | Protected Functions | Properties | Friends | List of all members
QToolBar Class Reference

The QToolBar class provides a movable panel that contains a set of controls. More...

#include <qtoolbar.h>

Inheritance diagram for QToolBar:
QWidget QObject QPaintDevice QmlJSDebugger::QmlToolBar

Public Slots

void setIconSize (const QSize &iconSize)
 
void setToolButtonStyle (Qt::ToolButtonStyle toolButtonStyle)
 
- 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 actionTriggered (QAction *action)
 This signal is emitted when an action in this toolbar is triggered. More...
 
void allowedAreasChanged (Qt::ToolBarAreas allowedAreas)
 This signal is emitted when the collection of allowed areas for the toolbar is changed. More...
 
void iconSizeChanged (const QSize &iconSize)
 This signal is emitted when the icon size is changed. More...
 
void movableChanged (bool movable)
 This signal is emitted when the toolbar becomes movable or fixed. More...
 
void orientationChanged (Qt::Orientation orientation)
 This signal is emitted when the orientation of the toolbar changes. More...
 
void toolButtonStyleChanged (Qt::ToolButtonStyle toolButtonStyle)
 This signal is emitted when the tool button style is changed. More...
 
void topLevelChanged (bool topLevel)
 This signal is emitted when the floating property changes. More...
 
void visibilityChanged (bool visible)
 This signal is emitted when the toolbar becomes visible (or invisible). 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

QActionactionAt (const QPoint &p) const
 Returns the action at point p. More...
 
QActionactionAt (int x, int y) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns the action at the point x, y. More...
 
QRect actionGeometry (QAction *action) const
 Returns the geometry of the toolbar item associated with the given action, or an invalid QRect if no matching item is found. More...
 
QActionaddAction (const QString &text)
 Creates a new action with the given text. More...
 
QActionaddAction (const QIcon &icon, const QString &text)
 Creates a new action with the given icon and text. More...
 
QActionaddAction (const QString &text, const QObject *receiver, const char *member)
 Creates a new action with the given text. More...
 
QActionaddAction (const QIcon &icon, const QString &text, const QObject *receiver, const char *member)
 Creates a new action with the icon icon and text text. More...
 
QActionaddSeparator ()
 Adds a separator to the end of the toolbar. More...
 
QActionaddWidget (QWidget *widget)
 Adds the given widget to the toolbar as the toolbar's last item. More...
 
Qt::ToolBarAreas allowedAreas () const
 areas where the toolbar may be placed More...
 
void clear ()
 Removes all actions from the toolbar. More...
 
QSize iconSize () const
 size of icons in the toolbar. More...
 
QActioninsertSeparator (QAction *before)
 Inserts a separator into the toolbar in front of the toolbar item associated with the before action. More...
 
QActioninsertWidget (QAction *before, QWidget *widget)
 Inserts the given widget in front of the toolbar item associated with the before action. More...
 
bool isAreaAllowed (Qt::ToolBarArea area) const
 Returns true if this toolbar is dockable in the given area; otherwise returns false. More...
 
bool isFloatable () const
 
bool isFloating () const
 
bool isMovable () const
 
Qt::Orientation orientation () const
 orientation of the toolbar More...
 
 QToolBar (const QString &title, QWidget *parent=0)
 Constructs a QToolBar with the given parent. More...
 
 QToolBar (QWidget *parent=0)
 Constructs a QToolBar with the given parent. More...
 
void setAllowedAreas (Qt::ToolBarAreas areas)
 
void setFloatable (bool floatable)
 
void setMovable (bool movable)
 
void setOrientation (Qt::Orientation orientation)
 
QActiontoggleViewAction () const
 Returns a checkable action that can be used to show or hide this toolbar. More...
 
Qt::ToolButtonStyle toolButtonStyle () const
 
QWidgetwidgetForAction (QAction *action) const
 Returns the widget associated with the specified action. More...
 
 ~QToolBar ()
 Destroys the toolbar. 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
 
QWidgetchildAt (int x, int y) const
 Returns the visible child widget at the position ({x}, {y}) in the widget's coordinate system. More...
 
QWidgetchildAt (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
 
QWidgetfocusProxy () const
 Returns the focus proxy, or 0 if there is no focus proxy. More...
 
QWidgetfocusWidget () const
 Returns the last child of this widget that setFocus had been called on. More...
 
const QFontfont () 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 QRectgeometry () 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...
 
QGraphicsEffectgraphicsEffect () const
 The graphicsEffect function returns a pointer to the widget's graphics effect. More...
 
QGraphicsProxyWidgetgraphicsProxyWidget () 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...
 
QInputContextinputContext ()
 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
 
QLayoutlayout () 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
 
virtual QSize minimumSizeHint () const
 
int minimumWidth () const
 
void move (int x, int y)
 This corresponds to move(QPoint(x, y)). More...
 
void move (const QPoint &)
 
QWidgetnativeParentWidget () const
 Returns the native parent for this widget, i. More...
 
QWidgetnextInFocusChain () 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)
 
QPaintEnginepaintEngine () const
 Returns the widget's paint engine. More...
 
const QPalettepalette () const
 
QWidgetparentWidget () const
 Returns the parent of this widget, or 0 if it does not have any parent widget. More...
 
QPoint pos () const
 
QWidgetpreviousInFocusChain () 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
 
virtual QSize sizeHint () 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
 
QStylestyle () 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
 
QWidgettopLevelWidget () 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
 
QWidgetwindow () 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...
 
QWindowSurfacewindowSurface () 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 QX11Infox11Info () 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 QObjectListchildren () 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< QByteArraydynamicPropertyNames () 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 >
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 QMetaObjectmetaObject () 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
 
QObjectparent () 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...
 
QThreadthread () const
 Returns the thread in which the object lives. More...
 
QObjectUserDatauserData (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 actionEvent (QActionEvent *event)
 Reimplemented Function More...
 
void changeEvent (QEvent *event)
 Reimplemented Function More...
 
void childEvent (QChildEvent *event)
 Reimplemented Function More...
 
bool event (QEvent *event)
 Reimplemented Function More...
 
void initStyleOption (QStyleOptionToolBar *option) const
 
void paintEvent (QPaintEvent *event)
 Reimplemented Function More...
 
void resizeEvent (QResizeEvent *event)
 Reimplemented Function More...
 
- Protected Functions inherited from QWidget
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 hideEvent (QHideEvent *)
 This event handler can be reimplemented in a subclass to receive widget hide events. More...
 
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 keyPressEvent (QKeyEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive key press events for the widget. 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 mouseMoveEvent (QMouseEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive mouse move events for the widget. More...
 
virtual void mousePressEvent (QMouseEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive mouse press events for the widget. More...
 
virtual void mouseReleaseEvent (QMouseEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive mouse release 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 showEvent (QShowEvent *)
 This event handler can be reimplemented in a subclass to receive widget show events which are passed in the event parameter. 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 wheelEvent (QWheelEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive wheel 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 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...
 
QObjectsender () 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

bool floatable
 whether the toolbar can be dragged and dropped as an independent window. More...
 
bool floating
 whether the toolbar is an independent window. More...
 
bool movable
 whether the user can move the toolbar within the toolbar area, or between toolbar areas More...
 
Qt::ToolButtonStyle toolButtonStyle
 the style of toolbar buttons More...
 

Friends

class QMainWindow
 
class QMainWindowLayout
 
class QToolBarAreaLayout
 
class QToolBarLayout
 

Additional Inherited Members

- 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
}
 
- Static Public Functions inherited from QWidget
static QWidgetfind (WId)
 Returns a pointer to the widget with window identifer/handle id. More...
 
static QWidgetkeyboardGrabber ()
 Returns the widget that is currently grabbing the keyboard input. More...
 
static QWidgetmouseGrabber ()
 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 QWSDisplayqwsDisplay ()
 
- 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< QObjectDatad_ptr
 
- Protected Variables inherited from QPaintDevice
ushort painters
 
- Static Protected Variables inherited from QObject
static const QMetaObject staticQtMetaObject
 

Detailed Description

The QToolBar class provides a movable panel that contains a set of controls.

Toolbar buttons are added by adding actions, using addAction() or insertAction(). Groups of buttons can be separated using addSeparator() or insertSeparator(). If a toolbar button is not appropriate, a widget can be inserted instead using addWidget() or insertWidget(); examples of suitable widgets are QSpinBox, QDoubleSpinBox, and QComboBox. When a toolbar button is pressed it emits the actionTriggered() signal.

A toolbar can be fixed in place in a particular area (e.g. at the top of the window), or it can be movable (isMovable()) between toolbar areas; see allowedAreas() and isAreaAllowed().

When a toolbar is resized in such a way that it is too small to show all the items it contains, an extension button will appear as the last item in the toolbar. Pressing the extension button will pop up a menu containing the items that does not currently fit in the toolbar.

When a QToolBar is not a child of a QMainWindow, it loses the ability to populate the extension pop up with widgets added to the toolbar using addWidget(). Please use widget actions created by inheriting QWidgetAction and implementing QWidgetAction::createWidget() instead.

See also
QToolButton, QMenu, QAction, {Application Example}

Definition at line 62 of file qtoolbar.h.

Constructors and Destructors

◆ QToolBar() [1/2]

QToolBar::QToolBar ( const QString title,
QWidget parent = 0 
)
explicit

Constructs a QToolBar with the given parent.

The given window title identifies the toolbar and is shown in the context menu provided by QMainWindow.

See also
setWindowTitle()

Definition at line 590 of file qtoolbar.cpp.

591  : QWidget(*new QToolBarPrivate, parent, 0)
592 {
593  Q_D(QToolBar);
594  d->init();
595  setWindowTitle(title);
596 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
void setWindowTitle(const QString &)
Definition: qwidget.cpp:6312
QWidget(QWidget *parent=0, Qt::WindowFlags f=0)
Constructs a widget which is a child of parent, with widget flags set to f.
Definition: qwidget.cpp:1189
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62

◆ QToolBar() [2/2]

QToolBar::QToolBar ( QWidget parent = 0)
explicit

Constructs a QToolBar with the given parent.

Definition at line 575 of file qtoolbar.cpp.

576  : QWidget(*new QToolBarPrivate, parent, 0)
577 {
578  Q_D(QToolBar);
579  d->init();
580 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
QWidget(QWidget *parent=0, Qt::WindowFlags f=0)
Constructs a widget which is a child of parent, with widget flags set to f.
Definition: qwidget.cpp:1189
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62

◆ ~QToolBar()

QToolBar::~QToolBar ( )

Destroys the toolbar.

Definition at line 617 of file qtoolbar.cpp.

618 {
619  // Remove the toolbar button if there is nothing left.
620  QMainWindow *mainwindow = qobject_cast<QMainWindow *>(parentWidget());
621  if (mainwindow) {
622 #ifdef Q_WS_MAC
623  QMainWindowLayout *mainwin_layout = qt_mainwindow_layout(mainwindow);
624  if (mainwin_layout && mainwin_layout->layoutState.toolBarAreaLayout.isEmpty()
625  && mainwindow->testAttribute(Qt::WA_WState_Created))
626  macWindowToolbarShow(mainwindow, false);
627 #endif
628  }
629 }
QWidget * parentWidget() const
Returns the parent of this widget, or 0 if it does not have any parent widget.
Definition: qwidget.h:1035
QMainWindowLayout * qt_mainwindow_layout(const QMainWindow *window)
QMainWindowLayoutState layoutState
T * qobject_cast(QObject *object)
Definition: qobject.h:375
bool testAttribute(Qt::WidgetAttribute) const
Returns true if attribute attribute is set on this widget; otherwise returns false.
Definition: qwidget.h:1041
The QMainWindow class provides a main application window.
Definition: qmainwindow.h:63
void macWindowToolbarShow(const QWidget *widget, bool show)
QToolBarAreaLayout toolBarAreaLayout

Functions

◆ actionAt() [1/2]

QAction * QToolBar::actionAt ( const QPoint p) const

Returns the action at point p.

This function returns zero if no action was found.

See also
QWidget::childAt()

Definition at line 1026 of file qtoolbar.cpp.

1027 {
1028  Q_D(const QToolBar);
1029  QWidget *widget = childAt(p);
1030  int index = d->layout->indexOf(widget);
1031  if (index == -1)
1032  return 0;
1033  QLayoutItem *item = d->layout->itemAt(index);
1034  return static_cast<QToolBarItem*>(item)->action;
1035 }
double d
Definition: qnumeric_p.h:62
QPointer< QWidget > widget
The QWidget class is the base class of all user interface objects.
Definition: qwidget.h:150
#define Q_D(Class)
Definition: qglobal.h:2482
The QLayoutItem class provides an abstract item that a QLayout manipulates.
Definition: qlayoutitem.h:64
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62
QWidget * childAt(int x, int y) const
Returns the visible child widget at the position ({x}, {y}) in the widget&#39;s coordinate system...
Definition: qwidget.h:934
quint16 index

◆ actionAt() [2/2]

QAction * QToolBar::actionAt ( int  x,
int  y 
) const
inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns the action at the point x, y.

This function returns zero if no action was found.

Definition at line 175 of file qtoolbar.h.

176 { return actionAt(QPoint(ax, ay)); }
QAction * actionAt(const QPoint &p) const
Returns the action at point p.
Definition: qtoolbar.cpp:1026
The QPoint class defines a point in the plane using integer precision.
Definition: qpoint.h:53

◆ actionEvent()

void QToolBar::actionEvent ( QActionEvent event)
protectedvirtual

Reimplemented Function

Reimplemented from QWidget.

Definition at line 1045 of file qtoolbar.cpp.

1046 {
1047  Q_D(QToolBar);
1048  QAction *action = event->action();
1049  QWidgetAction *widgetAction = qobject_cast<QWidgetAction *>(action);
1050 
1051  switch (event->type()) {
1052  case QEvent::ActionAdded: {
1053  Q_ASSERT_X(widgetAction == 0 || d->layout->indexOf(widgetAction) == -1,
1054  "QToolBar", "widgets cannot be inserted multiple times");
1055 
1056  // reparent the action to this toolbar if it has been created
1057  // using the addAction(text) etc. convenience functions, to
1058  // preserve Qt 4.1.x behavior. The widget is already
1059  // reparented to us due to the createWidget call inside
1060  // createItem()
1061  if (widgetAction != 0 && widgetAction->d_func()->autoCreated)
1062  widgetAction->setParent(this);
1063 
1064  int index = d->layout->count();
1065  if (event->before()) {
1066  index = d->layout->indexOf(event->before());
1067  Q_ASSERT_X(index != -1, "QToolBar::insertAction", "internal error");
1068  }
1069  d->layout->insertAction(index, action);
1070  break;
1071  }
1072 
1073  case QEvent::ActionChanged:
1074  d->layout->invalidate();
1075  break;
1076 
1077  case QEvent::ActionRemoved: {
1078  int index = d->layout->indexOf(action);
1079  if (index != -1) {
1080  delete d->layout->takeAt(index);
1081  }
1082  break;
1083  }
1084 
1085  default:
1086  Q_ASSERT_X(false, "QToolBar::actionEvent", "internal error");
1087  }
1088 }
QAction * before() const
If type() is ActionAdded , returns the action that should appear before action(). ...
Definition: qevent.h:640
double d
Definition: qnumeric_p.h:62
T * qobject_cast(QObject *object)
Definition: qobject.h:375
#define Q_D(Class)
Definition: qglobal.h:2482
void setParent(QObject *)
Makes the object a child of parent.
Definition: qobject.cpp:1950
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62
The QWidgetAction class extends QAction by an interface for inserting custom widgets into action base...
Definition: qwidgetaction.h:57
#define Q_ASSERT_X(cond, where, what)
Definition: qglobal.h:1837
quint16 index
Type type() const
Returns the event type.
Definition: qcoreevent.h:303
The QAction class provides an abstract user interface action that can be inserted into widgets...
Definition: qaction.h:64

◆ actionGeometry()

QRect QToolBar::actionGeometry ( QAction action) const

Returns the geometry of the toolbar item associated with the given action, or an invalid QRect if no matching item is found.

Warning
This function is not part of the public interface.

Definition at line 1010 of file qtoolbar.cpp.

1011 {
1012  Q_D(const QToolBar);
1013 
1014  int index = d->layout->indexOf(action);
1015  if (index == -1)
1016  return QRect();
1017  return d->layout->itemAt(index)->widget()->geometry();
1018 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62
The QRect class defines a rectangle in the plane using integer precision.
Definition: qrect.h:58
quint16 index

◆ actionTriggered

void QToolBar::actionTriggered ( QAction action)
signal

This signal is emitted when an action in this toolbar is triggered.

This happens when the action's tool button is pressed, or when the action is triggered in some other way outside the tool bar. The parameter holds the triggered action.

◆ addAction() [1/4]

QAction * QToolBar::addAction ( const QString text)

Creates a new action with the given text.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

This action is added to the end of the toolbar.

Definition at line 868 of file qtoolbar.cpp.

Referenced by addAction(), addSeparator(), addWidget(), QScriptDebugger::createStandardToolBar(), QPrintPreviewDialogPrivate::init(), QmlJSDebugger::QmlToolBar::QmlToolBar(), and QScriptBreakpointsWidget::QScriptBreakpointsWidget().

869 {
870  QAction *action = new QAction(text, this);
871  addAction(action);
872  return action;
873 }
QAction * addAction(const QString &text)
Creates a new action with the given text.
Definition: qtoolbar.cpp:868
The QAction class provides an abstract user interface action that can be inserted into widgets...
Definition: qaction.h:64

◆ addAction() [2/4]

QAction * QToolBar::addAction ( const QIcon icon,
const QString text 
)

Creates a new action with the given icon and text.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

This action is added to the end of the toolbar.

Definition at line 884 of file qtoolbar.cpp.

885 {
886  QAction *action = new QAction(icon, text, this);
887  addAction(action);
888  return action;
889 }
QAction * addAction(const QString &text)
Creates a new action with the given text.
Definition: qtoolbar.cpp:868
The QAction class provides an abstract user interface action that can be inserted into widgets...
Definition: qaction.h:64

◆ addAction() [3/4]

QAction * QToolBar::addAction ( const QString text,
const QObject receiver,
const char *  member 
)

Creates a new action with the given text.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

This action is added to the end of the toolbar. The action's triggered() signal is connected to member in receiver.

Definition at line 902 of file qtoolbar.cpp.

904 {
905  QAction *action = new QAction(text, this);
906  QObject::connect(action, SIGNAL(triggered(bool)), receiver, member);
907  addAction(action);
908  return action;
909 }
#define SIGNAL(a)
Definition: qobjectdefs.h:227
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 rece...
Definition: qobject.cpp:2580
QAction * addAction(const QString &text)
Creates a new action with the given text.
Definition: qtoolbar.cpp:868
The QAction class provides an abstract user interface action that can be inserted into widgets...
Definition: qaction.h:64

◆ addAction() [4/4]

QAction * QToolBar::addAction ( const QIcon icon,
const QString text,
const QObject receiver,
const char *  member 
)

Creates a new action with the 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.

This action is added to the end of the toolbar. The action's triggered() signal is connected to member in receiver.

Definition at line 922 of file qtoolbar.cpp.

924 {
925  QAction *action = new QAction(icon, text, this);
926  QObject::connect(action, SIGNAL(triggered(bool)), receiver, member);
927  addAction(action);
928  return action;
929 }
#define SIGNAL(a)
Definition: qobjectdefs.h:227
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 rece...
Definition: qobject.cpp:2580
QAction * addAction(const QString &text)
Creates a new action with the given text.
Definition: qtoolbar.cpp:868
The QAction class provides an abstract user interface action that can be inserted into widgets...
Definition: qaction.h:64

◆ addSeparator()

QAction * QToolBar::addSeparator ( )

Adds a separator to the end of the toolbar.

See also
insertSeparator()

Definition at line 936 of file qtoolbar.cpp.

Referenced by QScriptDebugger::createStandardToolBar(), QPrintPreviewDialogPrivate::init(), and QmlJSDebugger::QmlToolBar::QmlToolBar().

937 {
938  QAction *action = new QAction(this);
939  action->setSeparator(true);
940  addAction(action);
941  return action;
942 }
void setSeparator(bool b)
If b is true then this action will be considered a separator.
Definition: qaction.cpp:823
QAction * addAction(const QString &text)
Creates a new action with the given text.
Definition: qtoolbar.cpp:868
The QAction class provides an abstract user interface action that can be inserted into widgets...
Definition: qaction.h:64

◆ addWidget()

QAction * QToolBar::addWidget ( QWidget widget)

Adds the given widget to the toolbar as the toolbar's last item.

The toolbar takes ownership of widget.

If you add a QToolButton with this method, the tools bar's Qt::ToolButtonStyle will not be respected.

Note
You should use QAction::setVisible() to change the visibility of the widget. Using QWidget::setVisible(), QWidget::show() and QWidget::hide() does not work.
See also
insertWidget()

Definition at line 973 of file qtoolbar.cpp.

Referenced by QPrintPreviewDialogPrivate::init(), and QmlJSDebugger::QmlToolBar::QmlToolBar().

974 {
975  QWidgetAction *action = new QWidgetAction(this);
976  action->setDefaultWidget(widget);
977  action->d_func()->autoCreated = true;
978  addAction(action);
979  return action;
980 }
void setDefaultWidget(QWidget *w)
Sets widget to be the default widget.
The QWidgetAction class extends QAction by an interface for inserting custom widgets into action base...
Definition: qwidgetaction.h:57
QAction * addAction(const QString &text)
Creates a new action with the given text.
Definition: qtoolbar.cpp:868

◆ allowedAreas()

Qt::ToolBarAreas QToolBar::allowedAreas ( ) const

areas where the toolbar may be placed

The default is Qt::AllToolBarAreas.

This property only makes sense if the toolbar is in a QMainWindow.

See also
movable

Definition at line 724 of file qtoolbar.cpp.

725 {
726  Q_D(const QToolBar);
727 #ifdef Q_WS_MAC
728  if (QMainWindow *window = qobject_cast<QMainWindow *>(parentWidget())) {
729  if (window->unifiedTitleAndToolBarOnMac()) // Don't allow drags to the top (for now).
730  return (d->allowedAreas & ~Qt::TopToolBarArea);
731  }
732 #endif
733  return d->allowedAreas;
734 }
double d
Definition: qnumeric_p.h:62
QWidget * parentWidget() const
Returns the parent of this widget, or 0 if it does not have any parent widget.
Definition: qwidget.h:1035
#define Q_D(Class)
Definition: qglobal.h:2482
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62
The QMainWindow class provides a main application window.
Definition: qmainwindow.h:63
QWidget * window() const
Returns the window for this widget, i.e.
Definition: qwidget.cpp:4492

◆ allowedAreasChanged

void QToolBar::allowedAreasChanged ( Qt::ToolBarAreas  allowedAreas)
signal

This signal is emitted when the collection of allowed areas for the toolbar is changed.

The new areas in which the toolbar can be positioned are specified by allowedAreas.

See also
allowedAreas

Referenced by setAllowedAreas().

◆ changeEvent()

void QToolBar::changeEvent ( QEvent event)
protectedvirtual

Reimplemented Function

Reimplemented from QWidget.

Definition at line 1091 of file qtoolbar.cpp.

1092 {
1093  Q_D(QToolBar);
1094  switch (event->type()) {
1096  d->toggleViewAction->setText(windowTitle());
1097  break;
1098  case QEvent::StyleChange:
1099  d->layout->invalidate();
1100  if (!d->explicitIconSize)
1101  setIconSize(QSize());
1102  d->layout->updateMarginAndSpacing();
1103  break;
1105  d->layout->invalidate();
1106  break;
1107  default:
1108  break;
1109  }
1110  QWidget::changeEvent(event);
1111 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
void setIconSize(const QSize &iconSize)
Definition: qtoolbar.cpp:788
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62
virtual void changeEvent(QEvent *)
This event handler can be reimplemented to handle state changes.
Definition: qwidget.cpp:9170
QString windowTitle() const
The QSize class defines the size of a two-dimensional object using integer point precision.
Definition: qsize.h:53
Type type() const
Returns the event type.
Definition: qcoreevent.h:303

◆ childEvent()

void QToolBar::childEvent ( QChildEvent event)
protectedvirtual

Reimplemented Function

Reimplemented from QObject.

Definition at line 1407 of file qtoolbar.cpp.

1408 {
1409  QWidget::childEvent(event);
1410 }
virtual void childEvent(QChildEvent *)
This event handler can be reimplemented in a subclass to receive child events.
Definition: qobject.cpp:1332

◆ clear()

void QToolBar::clear ( )

Removes all actions from the toolbar.

See also
removeAction()

Definition at line 852 of file qtoolbar.cpp.

853 {
854  QList<QAction *> actions = this->actions();
855  for(int i = 0; i < actions.size(); i++)
856  removeAction(actions.at(i));
857 }
const T & at(int i) const
Returns the item at index position i in the list.
Definition: qlist.h:468
void removeAction(QAction *action)
Removes the action action from this widget&#39;s list of actions.
Definition: qwidget.cpp:3386
int size() const
Returns the number of items in the list.
Definition: qlist.h:137
QList< QAction * > actions() const
Returns the (possibly empty) list of this widget&#39;s actions.
Definition: qwidget.cpp:3407
The QList class is a template class that provides lists.
Definition: qdatastream.h:62

◆ event()

bool QToolBar::event ( QEvent event)
protectedvirtual

Reimplemented Function

Reimplemented from QWidget.

Definition at line 1180 of file qtoolbar.cpp.

1181 {
1182  Q_D(QToolBar);
1183 
1184  switch (event->type()) {
1185  case QEvent::Timer:
1186  if (d->waitForPopupTimer.timerId() == static_cast<QTimerEvent*>(event)->timerId()) {
1188  if (!waitForPopup(this, w)) {
1189  d->waitForPopupTimer.stop();
1190  if (!this->underMouse())
1191  d->layout->setExpanded(false);
1192  }
1193  }
1194  break;
1195  case QEvent::Hide:
1196  if (!isHidden())
1197  break;
1198  // fallthrough intended
1199  case QEvent::Show:
1200  d->toggleViewAction->setChecked(event->type() == QEvent::Show);
1201  emit visibilityChanged(event->type() == QEvent::Show);
1202 #if defined(Q_WS_MAC)
1203  if (toolbarInUnifiedToolBar(this)) {
1204  // I can static_cast because I did the qobject_cast in the if above, therefore
1205  // we must have a QMainWindowLayout here.
1206  QMainWindowLayout *mwLayout = qt_mainwindow_layout(qobject_cast<QMainWindow *>(parentWidget()));
1207  mwLayout->fixSizeInUnifiedToolbar(this);
1208  mwLayout->syncUnifiedToolbarVisibility();
1209  }
1210 # if !defined(QT_MAC_USE_COCOA)
1211  // Fall through
1212  case QEvent::LayoutRequest: {
1213  // There's currently no way to invalidate the size and let
1214  // HIToolbar know about it. This forces a re-check.
1215  int earlyResult = -1;
1216  if (QMainWindow *mainWindow = qobject_cast<QMainWindow *>(parentWidget())) {
1217  bool needUpdate = true;
1218  if (event->type() == QEvent::LayoutRequest) {
1219  QSize oldSizeHint = sizeHint();
1220  earlyResult = QWidget::event(event) ? 1 : 0;
1221  needUpdate = oldSizeHint != sizeHint();
1222  }
1223 
1224  if (needUpdate) {
1225  OSWindowRef windowRef = qt_mac_window_for(mainWindow);
1226  if (toolbarInUnifiedToolBar(this)
1227  && macWindowToolbarIsVisible(windowRef)) {
1228  DisableScreenUpdates();
1229  macWindowToolbarShow(this, false);
1230  macWindowToolbarShow(this, true);
1231  EnableScreenUpdates();
1232  }
1233  }
1234 
1235  if (earlyResult != -1)
1236  return earlyResult;
1237  }
1238  }
1239 # endif // !QT_MAC_USE_COCOA
1240 #endif // Q_WS_MAC
1241  break;
1242  case QEvent::ParentChange:
1243  d->layout->checkUsePopupMenu();
1244 #if defined(Q_WS_MAC)
1245  if (parentWidget() && parentWidget()->isWindow())
1247 #endif
1248  break;
1249 
1250  case QEvent::MouseButtonPress: {
1251  if (d->mousePressEvent(static_cast<QMouseEvent*>(event)))
1252  return true;
1253  break;
1254  }
1256  if (d->mouseReleaseEvent(static_cast<QMouseEvent*>(event)))
1257  return true;
1258  break;
1259  case QEvent::HoverEnter:
1260  case QEvent::HoverLeave:
1261  // there's nothing special to do here and we don't want to update the whole widget
1262  return true;
1263  case QEvent::HoverMove: {
1264 #ifndef QT_NO_CURSOR
1265  QHoverEvent *e = static_cast<QHoverEvent*>(event);
1266  QStyleOptionToolBar opt;
1267  initStyleOption(&opt);
1268  if (style()->subElementRect(QStyle::SE_ToolBarHandle, &opt, this).contains(e->pos()))
1270  else
1271  unsetCursor();
1272 #endif
1273  break;
1274  }
1275  case QEvent::MouseMove:
1276  if (d->mouseMoveEvent(static_cast<QMouseEvent*>(event)))
1277  return true;
1278  break;
1279 #ifdef Q_WS_WINCE
1280  case QEvent::ContextMenu:
1281  {
1283  QWidget* child = childAt(contextMenuEvent->pos());
1284  QAbstractButton* button = qobject_cast<QAbstractButton*>(child);
1285  if (button)
1286  button->setDown(false);
1287  }
1288  break;
1289 #endif
1290  case QEvent::Leave:
1291  if (d->state != 0 && d->state->dragging) {
1292 #ifdef Q_OS_WIN
1293  // This is a workaround for loosing the mouse on Vista.
1294  QPoint pos = QCursor::pos();
1297  d->mouseMoveEvent(&fake);
1298 #endif
1299  } else {
1300  if (!d->layout->expanded)
1301  break;
1302 
1304  if (waitForPopup(this, w)) {
1305  d->waitForPopupTimer.start(POPUP_TIMER_INTERVAL, this);
1306  break;
1307  }
1308 
1309  d->waitForPopupTimer.stop();
1310  d->layout->setExpanded(false);
1311  break;
1312  }
1313  default:
1314  break;
1315  }
1316  return QWidget::event(event);
1317 }
The QAbstractButton class is the abstract base class of button widgets, providing functionality commo...
QPoint pos() const
double d
Definition: qnumeric_p.h:62
QWidget * parentWidget() const
Returns the parent of this widget, or 0 if it does not have any parent widget.
Definition: qwidget.h:1035
QMainWindowLayout * qt_mainwindow_layout(const QMainWindow *window)
static void qt_mac_updateToolBarButtonHint(QWidget *parentWidget)
Definition: qtoolbar.cpp:78
void unsetCursor()
Definition: qwidget.cpp:5311
bool isWindow() const
Returns true if the widget is an independent window, otherwise returns false.
Definition: qwidget.h:945
The QContextMenuEvent class contains parameters that describe a context menu event.
Definition: qevent.h:396
const QPoint & pos() const
Returns the position of the mouse pointer relative to the widget that received the event...
Definition: qevent.h:412
The QHoverEvent class contains parameters that describe a mouse event.
Definition: qevent.h:125
The QWidget class is the base class of all user interface objects.
Definition: qwidget.h:150
The QStyleOptionToolBar class is used to describe the parameters for drawing a toolbar.
Definition: qstyleoption.h:369
bool underMouse() const
Returns true if the widget is under the mouse cursor; otherwise returns false.
Definition: qwidget.h:996
friend OSWindowRef qt_mac_window_for(const QWidget *w)
Definition: qwidget_mac.mm:484
T * qobject_cast(QObject *object)
Definition: qobject.h:375
#define Q_D(Class)
Definition: qglobal.h:2482
bool macWindowToolbarIsVisible(void *window)
virtual QSize sizeHint() const
QStyle * style() const
Definition: qwidget.cpp:2742
bool isHidden() const
Returns true if the widget is hidden, otherwise returns false.
Definition: qwidget.h:1008
void visibilityChanged(bool visible)
This signal is emitted when the toolbar becomes visible (or invisible).
WindowRef OSWindowRef
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62
QWidget * childAt(int x, int y) const
Returns the visible child widget at the position ({x}, {y}) in the widget&#39;s coordinate system...
Definition: qwidget.h:934
#define emit
Definition: qobjectdefs.h:76
#define POPUP_TIMER_INTERVAL
Definition: qtoolbar.cpp:73
void setCursor(const QCursor &)
Definition: qwidget.cpp:5290
static bool toolbarInUnifiedToolBar(QToolBar *toolbar)
Definition: qtoolbar.cpp:1171
The QMouseEvent class contains parameters that describe a mouse event.
Definition: qevent.h:85
virtual void contextMenuEvent(QContextMenuEvent *)
This event handler, for event event, can be reimplemented in a subclass to receive widget context men...
Definition: qwidget.cpp:9645
const QPoint & pos() const
Returns the position of the mouse cursor, relative to the widget that received the event...
Definition: qevent.h:131
static Qt::KeyboardModifiers keyboardModifiers()
Returns the current state of the modifier keys on the keyboard.
static QWidget * activePopupWidget()
Returns the active popup widget.
The QTimerEvent class contains parameters that describe a timer event.
Definition: qcoreevent.h:341
The QPoint class defines a point in the plane using integer precision.
Definition: qpoint.h:53
The QMainWindow class provides a main application window.
Definition: qmainwindow.h:63
bool event(QEvent *event)
Reimplemented Function
Definition: qtoolbar.cpp:1180
void macWindowToolbarShow(const QWidget *widget, bool show)
void initStyleOption(QStyleOptionToolBar *option) const
Definition: qtoolbar.cpp:1374
QPoint mapFromGlobal(const QPoint &) const
Translates the global screen coordinate pos to widget coordinates.
The QSize class defines the size of a two-dimensional object using integer point precision.
Definition: qsize.h:53
static Qt::MouseButtons mouseButtons()
Returns the current state of the buttons on the mouse.
static bool waitForPopup(QToolBar *tb, QWidget *popup)
Definition: qtoolbar.cpp:1144
bool event(QEvent *)
This is the main event handler; it handles event event.
Definition: qwidget.cpp:8636
void fixSizeInUnifiedToolbar(QToolBar *tb) const
Type type() const
Returns the event type.
Definition: qcoreevent.h:303
static QPoint pos()
Returns the position of the cursor (hot spot) in global screen coordinates.
Definition: qcursor_mac.mm:310

◆ iconSize()

QSize QToolBar::iconSize ( ) const

size of icons in the toolbar.

The default size is determined by the application's style and is derived from the QStyle::PM_ToolBarIconSize pixel metric. It is the maximum size an icon can have. Icons of smaller size will not be scaled up.

Definition at line 785 of file qtoolbar.cpp.

Referenced by QToolBarLayout::createItem(), and setIconSize().

786 { Q_D(const QToolBar); return d->iconSize; }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62

◆ iconSizeChanged

void QToolBar::iconSizeChanged ( const QSize iconSize)
signal

This signal is emitted when the icon size is changed.

The iconSize parameter holds the toolbar's new icon size.

See also
iconSize QMainWindow::iconSize

Referenced by setIconSize().

◆ initStyleOption()

void QToolBar::initStyleOption ( QStyleOptionToolBar option) const
protected
Warning
This function is not part of the public interface.

Definition at line 1374 of file qtoolbar.cpp.

Referenced by event(), QToolBarLayout::expandedSize(), QToolBarLayout::layoutActions(), paintEvent(), QToolBarLayout::setGeometry(), QToolBarLayout::updateGeomArray(), and QToolBarLayout::updateMarginAndSpacing().

1375 {
1376  Q_D(const QToolBar);
1377 
1378  if (!option)
1379  return;
1380 
1381  option->initFrom(this);
1382  if (orientation() == Qt::Horizontal)
1383  option->state |= QStyle::State_Horizontal;
1385  option->features = d->layout->movable()
1388  // if the tool bar is not in a QMainWindow, this will make the painting right
1389  option->toolBarArea = Qt::NoToolBarArea;
1390 
1391  // Add more styleoptions if the toolbar has been added to a mainwindow.
1392  QMainWindow *mainWindow = qobject_cast<QMainWindow *>(parentWidget());
1393 
1394  if (!mainWindow)
1395  return;
1396 
1398  Q_ASSERT_X(layout != 0, "QToolBar::initStyleOption()",
1399  "QMainWindow->layout() != QMainWindowLayout");
1400 
1401  layout->getStyleOptionInfo(option, const_cast<QToolBar *>(this));
1402 }
double d
Definition: qnumeric_p.h:62
QWidget * parentWidget() const
Returns the parent of this widget, or 0 if it does not have any parent widget.
Definition: qwidget.h:1035
QMainWindowLayout * qt_mainwindow_layout(const QMainWindow *window)
QStyle::State state
the style flags that are used when drawing the control
Definition: qstyleoption.h:88
virtual int pixelMetric(PixelMetric metric, const QStyleOption *option=0, const QWidget *widget=0) const =0
Returns the value of the given pixel metric.
int lineWidth
This variable holds the line width for drawing the toolbar.
Definition: qstyleoption.h:381
ToolBarFeatures features
This variable holds whether the toolbar is movable or not.
Definition: qstyleoption.h:380
T * qobject_cast(QObject *object)
Definition: qobject.h:375
#define Q_D(Class)
Definition: qglobal.h:2482
QStyle * style() const
Definition: qwidget.cpp:2742
void getStyleOptionInfo(QStyleOptionToolBar *option, QToolBar *toolBar) const
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62
void initFrom(const QWidget *w)
Definition: qstyleoption.h:99
#define Q_ASSERT_X(cond, where, what)
Definition: qglobal.h:1837
Qt::Orientation orientation() const
orientation of the toolbar
Definition: qtoolbar.cpp:769
The QMainWindow class provides a main application window.
Definition: qmainwindow.h:63
QLayout * layout() const
Returns the layout manager that is installed on this widget, or 0 if no layout manager is installed...
Definition: qwidget.cpp:10073
Qt::ToolBarArea toolBarArea
This variable holds the location for drawing the toolbar.
Definition: qstyleoption.h:379

◆ insertSeparator()

QAction * QToolBar::insertSeparator ( QAction before)

Inserts a separator into the toolbar in front of the toolbar item associated with the before action.

See also
addSeparator()

Definition at line 950 of file qtoolbar.cpp.

951 {
952  QAction *action = new QAction(this);
953  action->setSeparator(true);
954  insertAction(before, action);
955  return action;
956 }
void setSeparator(bool b)
If b is true then this action will be considered a separator.
Definition: qaction.cpp:823
void insertAction(QAction *before, QAction *action)
Inserts the action action to this widget&#39;s list of actions, before the action before.
Definition: qwidget.cpp:3342
The QAction class provides an abstract user interface action that can be inserted into widgets...
Definition: qaction.h:64

◆ insertWidget()

QAction * QToolBar::insertWidget ( QAction before,
QWidget widget 
)

Inserts the given widget in front of the toolbar item associated with the before action.

Note: You should use QAction::setVisible() to change the visibility of the widget. Using QWidget::setVisible(), QWidget::show() and QWidget::hide() does not work.

See also
addWidget()

Definition at line 992 of file qtoolbar.cpp.

993 {
994  QWidgetAction *action = new QWidgetAction(this);
995  action->setDefaultWidget(widget);
996  action->d_func()->autoCreated = true;
997  insertAction(before, action);
998  return action;
999 }
void setDefaultWidget(QWidget *w)
Sets widget to be the default widget.
The QWidgetAction class extends QAction by an interface for inserting custom widgets into action base...
Definition: qwidgetaction.h:57
void insertAction(QAction *before, QAction *action)
Inserts the action action to this widget&#39;s list of actions, before the action before.
Definition: qwidget.cpp:3342

◆ isAreaAllowed()

bool QToolBar::isAreaAllowed ( Qt::ToolBarArea  area) const
inline

Returns true if this toolbar is dockable in the given area; otherwise returns false.

Definition at line 88 of file qtoolbar.h.

89  { return (allowedAreas() & area) == area; }
Qt::ToolBarAreas allowedAreas() const
areas where the toolbar may be placed
Definition: qtoolbar.cpp:724
static int area(const QSize &s)
Definition: qicon.cpp:155

◆ isFloatable()

bool QToolBar::isFloatable ( ) const

Definition at line 671 of file qtoolbar.cpp.

672 {
673  Q_D(const QToolBar);
674  return d->floatable;
675 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62

◆ isFloating()

bool QToolBar::isFloating ( ) const

Definition at line 694 of file qtoolbar.cpp.

Referenced by QToolBarLayout::checkUsePopupMenu().

695 {
696  return isWindow();
697 }
bool isWindow() const
Returns true if the widget is an independent window, otherwise returns false.
Definition: qwidget.h:945

◆ isMovable()

bool QToolBar::isMovable ( ) const

Definition at line 656 of file qtoolbar.cpp.

Referenced by QMainWindowLayout::insertIntoMacToolbar(), and QToolBarLayout::movable().

657 {
658  Q_D(const QToolBar);
659  return d->movable;
660 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62

◆ movableChanged

void QToolBar::movableChanged ( bool  movable)
signal

This signal is emitted when the toolbar becomes movable or fixed.

If the toolbar can be moved, movable is true; otherwise it is false.

See also
movable

Referenced by setMovable().

◆ orientation()

Qt::Orientation QToolBar::orientation ( ) const

orientation of the toolbar

The default is Qt::Horizontal.

This function should not be used when the toolbar is managed by QMainWindow. You can use QMainWindow::addToolBar() or QMainWindow::insertToolBar() if you wish to move a toolbar (that is already added to a main window) to another Qt::ToolBarArea.

Definition at line 769 of file qtoolbar.cpp.

Referenced by QPushButtonPrivate::adjustedMenuPosition(), QToolBarLayout::checkUsePopupMenu(), QToolBarLayout::expandedSize(), QToolBarLayout::expandingDirections(), fixToolBarOrientation(), initStyleOption(), QToolBarLayout::layoutActions(), QToolButtonPrivate::popupTimerDone(), QToolBarLayout::setGeometry(), setOrientation(), and QToolBarLayout::updateGeomArray().

770 { Q_D(const QToolBar); return d->orientation; }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62

◆ orientationChanged

void QToolBar::orientationChanged ( Qt::Orientation  orientation)
signal

This signal is emitted when the orientation of the toolbar changes.

The new orientation is specified by the orientation given.

See also
orientation

Referenced by setOrientation().

◆ paintEvent()

void QToolBar::paintEvent ( QPaintEvent event)
protectedvirtual

Reimplemented Function

Reimplemented from QWidget.

Definition at line 1114 of file qtoolbar.cpp.

1115 {
1116  Q_D(QToolBar);
1117 
1118  QPainter p(this);
1119  QStyle *style = this->style();
1120  QStyleOptionToolBar opt;
1121  initStyleOption(&opt);
1122 
1123  if (d->layout->expanded || d->layout->animating || isWindow()) {
1124  //if the toolbar is expended, we need to fill the background with the window color
1125  //because some styles may expects that.
1126  p.fillRect(opt.rect, palette().background());
1127  style->drawControl(QStyle::CE_ToolBar, &opt, &p, this);
1128  style->drawPrimitive(QStyle::PE_FrameMenu, &opt, &p, this);
1129  } else {
1130  style->drawControl(QStyle::CE_ToolBar, &opt, &p, this);
1131  }
1132 
1133  opt.rect = style->subElementRect(QStyle::SE_ToolBarHandle, &opt, this);
1134  if (opt.rect.isValid())
1135  style->drawPrimitive(QStyle::PE_IndicatorToolBarHandle, &opt, &p, this);
1136 }
The QPainter class performs low-level painting on widgets and other paint devices.
Definition: qpainter.h:86
double d
Definition: qnumeric_p.h:62
bool isWindow() const
Returns true if the widget is an independent window, otherwise returns false.
Definition: qwidget.h:945
The QStyleOptionToolBar class is used to describe the parameters for drawing a toolbar.
Definition: qstyleoption.h:369
#define Q_D(Class)
Definition: qglobal.h:2482
QStyle * style() const
Definition: qwidget.cpp:2742
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62
const QPalette & palette() const
virtual void drawPrimitive(PrimitiveElement pe, const QStyleOption *opt, QPainter *p, const QWidget *w=0) const =0
Draws the given primitive element with the provided painter using the style options specified by opti...
virtual QRect subElementRect(SubElement subElement, const QStyleOption *option, const QWidget *widget=0) const =0
Returns the sub-area for the given element as described in the provided style option.
virtual void drawControl(ControlElement element, const QStyleOption *opt, QPainter *p, const QWidget *w=0) const =0
Draws the given element with the provided painter with the style options specified by option...
The QStyle class is an abstract base class that encapsulates the look and feel of a GUI...
Definition: qstyle.h:68
void initStyleOption(QStyleOptionToolBar *option) const
Definition: qtoolbar.cpp:1374
bool isValid() const
Returns true if the rectangle is valid, otherwise returns false.
Definition: qrect.h:237
QRect rect
the area that should be used for various calculations and painting
Definition: qstyleoption.h:90

◆ resizeEvent()

void QToolBar::resizeEvent ( QResizeEvent event)
protectedvirtual

Reimplemented Function

Reimplemented from QWidget.

Definition at line 1415 of file qtoolbar.cpp.

1416 {
1417  QWidget::resizeEvent(event);
1418 }
virtual void resizeEvent(QResizeEvent *)
This event handler can be reimplemented in a subclass to receive widget resize events which are passe...
Definition: qwidget.cpp:9587

◆ setAllowedAreas()

void QToolBar::setAllowedAreas ( Qt::ToolBarAreas  areas)

Definition at line 714 of file qtoolbar.cpp.

715 {
716  Q_D(QToolBar);
717  areas &= Qt::ToolBarArea_Mask;
718  if (areas == d->allowedAreas)
719  return;
720  d->allowedAreas = areas;
721  emit allowedAreasChanged(d->allowedAreas);
722 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62
#define emit
Definition: qobjectdefs.h:76
void allowedAreasChanged(Qt::ToolBarAreas allowedAreas)
This signal is emitted when the collection of allowed areas for the toolbar is changed.

◆ setFloatable()

void QToolBar::setFloatable ( bool  floatable)

Definition at line 677 of file qtoolbar.cpp.

678 {
679  Q_D(QToolBar);
680  d->floatable = floatable;
681 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62
bool floatable
whether the toolbar can be dragged and dropped as an independent window.
Definition: qtoolbar.h:75

◆ setIconSize

void QToolBar::setIconSize ( const QSize iconSize)
slot

Definition at line 788 of file qtoolbar.cpp.

Referenced by changeEvent().

789 {
790  Q_D(QToolBar);
791  QSize sz = iconSize;
792  if (!sz.isValid()) {
794  if (mw && mw->layout()) {
795  QLayout *layout = mw->layout();
796  int i = 0;
797  QLayoutItem *item = 0;
798  do {
799  item = layout->itemAt(i++);
800  if (item && (item->widget() == this))
801  sz = mw->iconSize();
802  } while (!sz.isValid() && item != 0);
803  }
804  }
805  if (!sz.isValid()) {
806  const int metric = style()->pixelMetric(QStyle::PM_ToolBarIconSize, 0, this);
807  sz = QSize(metric, metric);
808  }
809  if (d->iconSize != sz) {
810  d->iconSize = sz;
811  setMinimumSize(0, 0);
812  emit iconSizeChanged(d->iconSize);
813  }
814  d->explicitIconSize = iconSize.isValid();
815 
816  d->layout->invalidate();
817 }
double d
Definition: qnumeric_p.h:62
QWidget * parentWidget() const
Returns the parent of this widget, or 0 if it does not have any parent widget.
Definition: qwidget.h:1035
virtual QLayoutItem * itemAt(int index) const =0
Must be implemented in subclasses to return the layout item at index.
int metric(PaintDeviceMetric) const
Internal implementation of the virtual QPaintDevice::metric() function.
virtual int pixelMetric(PixelMetric metric, const QStyleOption *option=0, const QWidget *widget=0) const =0
Returns the value of the given pixel metric.
void setMinimumSize(const QSize &)
Definition: qwidget.h:969
T * qobject_cast(QObject *object)
Definition: qobject.h:375
#define Q_D(Class)
Definition: qglobal.h:2482
QStyle * style() const
Definition: qwidget.cpp:2742
The QLayoutItem class provides an abstract item that a QLayout manipulates.
Definition: qlayoutitem.h:64
QSize iconSize
size of toolbar icons in this mainwindow.
Definition: qmainwindow.h:69
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62
The QLayout class is the base class of geometry managers.
Definition: qlayout.h:90
#define emit
Definition: qobjectdefs.h:76
void iconSizeChanged(const QSize &iconSize)
This signal is emitted when the icon size is changed.
QSize iconSize() const
size of icons in the toolbar.
Definition: qtoolbar.cpp:785
The QMainWindow class provides a main application window.
Definition: qmainwindow.h:63
bool isValid() const
Returns true if both the width and height is equal to or greater than 0; otherwise returns false...
Definition: qsize.h:123
virtual QWidget * widget()
If this item is a QWidget, it is returned as a QWidget; otherwise 0 is returned.
QLayout * layout() const
Returns the layout manager that is installed on this widget, or 0 if no layout manager is installed...
Definition: qwidget.cpp:10073
The QSize class defines the size of a two-dimensional object using integer point precision.
Definition: qsize.h:53

◆ setMovable()

void QToolBar::setMovable ( bool  movable)

Definition at line 646 of file qtoolbar.cpp.

Referenced by QMainWindowLayout::insertIntoMacToolbar(), and QMainWindowLayout::removeFromMacToolbar().

647 {
648  Q_D(QToolBar);
649  if (!movable == !d->movable)
650  return;
651  d->movable = movable;
652  d->layout->invalidate();
653  emit movableChanged(d->movable);
654 }
double d
Definition: qnumeric_p.h:62
bool movable
whether the user can move the toolbar within the toolbar area, or between toolbar areas ...
Definition: qtoolbar.h:66
#define Q_D(Class)
Definition: qglobal.h:2482
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62
#define emit
Definition: qobjectdefs.h:76
void movableChanged(bool movable)
This signal is emitted when the toolbar becomes movable or fixed.

◆ setOrientation()

void QToolBar::setOrientation ( Qt::Orientation  orientation)

Definition at line 750 of file qtoolbar.cpp.

Referenced by fixToolBarOrientation(), QToolBarAreaLayoutInfo::insertToolBar(), and QToolBarAreaLayout::restoreState().

751 {
752  Q_D(QToolBar);
753  if (orientation == d->orientation)
754  return;
755 
756  d->orientation = orientation;
757 
758  if (orientation == Qt::Vertical)
760  else
762 
763  d->layout->invalidate();
764  d->layout->activate();
765 
766  emit orientationChanged(d->orientation);
767 }
double d
Definition: qnumeric_p.h:62
void orientationChanged(Qt::Orientation orientation)
This signal is emitted when the orientation of the toolbar changes.
#define Q_D(Class)
Definition: qglobal.h:2482
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62
#define emit
Definition: qobjectdefs.h:76
Qt::Orientation orientation() const
orientation of the toolbar
Definition: qtoolbar.cpp:769
void setSizePolicy(QSizePolicy)
Definition: qwidget.cpp:10198

◆ setToolButtonStyle

void QToolBar::setToolButtonStyle ( Qt::ToolButtonStyle  toolButtonStyle)
slot

Definition at line 836 of file qtoolbar.cpp.

837 {
838  Q_D(QToolBar);
839  d->explicitToolButtonStyle = true;
840  if (d->toolButtonStyle == toolButtonStyle)
841  return;
842  d->toolButtonStyle = toolButtonStyle;
843  setMinimumSize(0, 0);
844  emit toolButtonStyleChanged(d->toolButtonStyle);
845 }
double d
Definition: qnumeric_p.h:62
void setMinimumSize(const QSize &)
Definition: qwidget.h:969
#define Q_D(Class)
Definition: qglobal.h:2482
void toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)
This signal is emitted when the tool button style is changed.
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62
#define emit
Definition: qobjectdefs.h:76
Qt::ToolButtonStyle toolButtonStyle() const

◆ toggleViewAction()

QAction * QToolBar::toggleViewAction ( ) const

Returns a checkable action that can be used to show or hide this toolbar.

The action's text is set to the toolbar's window title.

See also
QAction::text QWidget::windowTitle

Definition at line 1327 of file qtoolbar.cpp.

Referenced by QMainWindow::createPopupMenu().

1328 { Q_D(const QToolBar); return d->toggleViewAction; }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62

◆ toolButtonStyle()

Qt::ToolButtonStyle QToolBar::toolButtonStyle ( ) const

Referenced by setIconSize(), and setToolButtonStyle().

◆ toolButtonStyleChanged

void QToolBar::toolButtonStyleChanged ( Qt::ToolButtonStyle  toolButtonStyle)
signal

This signal is emitted when the tool button style is changed.

The toolButtonStyle parameter holds the toolbar's new tool button style.

See also
toolButtonStyle QMainWindow::toolButtonStyle

Referenced by setToolButtonStyle().

◆ topLevelChanged

void QToolBar::topLevelChanged ( bool  topLevel)
signal

This signal is emitted when the floating property changes.

Since
4.6

The topLevel parameter is true if the toolbar is now floating; otherwise it is false.

See also
isWindow()

◆ visibilityChanged

void QToolBar::visibilityChanged ( bool  visible)
signal

This signal is emitted when the toolbar becomes visible (or invisible).

Since
4.7

This happens when the widget is hidden or shown.

Referenced by event().

◆ widgetForAction()

QWidget * QToolBar::widgetForAction ( QAction action) const

Returns the widget associated with the specified action.

Since
4.2
See also
addWidget()

Definition at line 1358 of file qtoolbar.cpp.

Referenced by QPrintPreviewDialogPrivate::init().

1359 {
1360  Q_D(const QToolBar);
1361 
1362  int index = d->layout->indexOf(action);
1363  if (index == -1)
1364  return 0;
1365 
1366  return d->layout->itemAt(index)->widget();
1367 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QToolBar class provides a movable panel that contains a set of controls.
Definition: qtoolbar.h:62
quint16 index

Friends and Related Functions

◆ QMainWindow

friend class QMainWindow
friend

Definition at line 169 of file qtoolbar.h.

◆ QMainWindowLayout

friend class QMainWindowLayout
friend

Definition at line 170 of file qtoolbar.h.

◆ QToolBarAreaLayout

friend class QToolBarAreaLayout
friend

Definition at line 172 of file qtoolbar.h.

◆ QToolBarLayout

friend class QToolBarLayout
friend

Definition at line 171 of file qtoolbar.h.

Properties

◆ floatable

QToolBar::floatable
private

whether the toolbar can be dragged and dropped as an independent window.

The default is true.

Definition at line 75 of file qtoolbar.h.

Referenced by setFloatable().

◆ floating

QToolBar::floating
private

whether the toolbar is an independent window.

By default, this property is true.

See also
QWidget::isWindow()

Definition at line 74 of file qtoolbar.h.

◆ movable

QToolBar::movable
private

whether the user can move the toolbar within the toolbar area, or between toolbar areas

By default, this property is true.

This property only makes sense if the toolbar is in a QMainWindow.

See also
allowedAreas

Definition at line 66 of file qtoolbar.h.

Referenced by setMovable().

◆ toolButtonStyle

Qt::ToolButtonStyle QToolBar::toolButtonStyle
private
Initial value:

the style of toolbar buttons

This property defines the style of all tool buttons that are added as QAction. Note that if you add a QToolButton with the addWidget() method, it will not get this button style.

The default is Qt::ToolButtonIconOnly.

Definition at line 70 of file qtoolbar.h.

Referenced by QToolBarLayout::createItem().


The documentation for this class was generated from the following files: