QToolBar#

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

Synopsis#

Functions#

def actionAt (p)
def actionAt (x, y)
def actionGeometry (action)
def addSeparator ()
def addWidget (widget)
def allowedAreas ()
def clear ()
def iconSize ()
def insertSeparator (before)
def insertWidget (before, widget)
def isAreaAllowed (area)
def isFloatable ()
def isFloating ()
def isMovable ()
def orientation ()
def setAllowedAreas (areas)
def setFloatable (floatable)
def setMovable (movable)
def setOrientation (orientation)
def toggleViewAction ()
def toolButtonStyle ()
def widgetForAction (action)

Virtual functions#

def initStyleOption (option)

Slots#

def setIconSize (iconSize)
def setToolButtonStyle (toolButtonStyle)

Signals#

def actionTriggered (action)
def allowedAreasChanged (allowedAreas)
def iconSizeChanged (iconSize)
def movableChanged (movable)
def orientationChanged (orientation)
def toolButtonStyleChanged (toolButtonStyle)
def topLevelChanged (topLevel)
def visibilityChanged (visible)

Detailed Description#

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 between toolbar areas; see setMovable() , isMovable() , 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 do 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 createWidget() instead.

See also

QToolButton QMenu QAction Qt Widgets - Application Example

class PySide6.QtWidgets.QToolBar([parent=None])#

PySide6.QtWidgets.QToolBar(title[, parent=None])

Parameters

parent – PySide6.QtWidgets.QWidget
title – str

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()

PySide6.QtWidgets.QToolBar.actionAt(p)#

Parameters: p – PySide6.QtCore.QPoint
Return type: PySide6.QtGui.QAction

Returns the action at point p. This function returns zero if no action was found.

See also

childAt()

PySide6.QtWidgets.QToolBar.actionAt(x, y)

Parameters

x – int
y – int

Return type

PySide6.QtGui.QAction

This is an overloaded function.

Returns the action at the point x, y. This function returns zero if no action was found.

PySide6.QtWidgets.QToolBar.actionGeometry(action)#

Parameters: action – PySide6.QtGui.QAction
Return type: PySide6.QtCore.QRect

PySide6.QtWidgets.QToolBar.actionTriggered(action)#

Parameters: action – PySide6.QtGui.QAction

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 toolbar. The parameter holds the triggered action.

PySide6.QtWidgets.QToolBar.addSeparator()#

Return type: PySide6.QtGui.QAction

Adds a separator to the end of the toolbar.

See also

insertSeparator()

PySide6.QtWidgets.QToolBar.addWidget(widget)#

Parameters: widget – PySide6.QtWidgets.QWidget
Return type: PySide6.QtGui.QAction

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 toolbar’s ToolButtonStyle will not be respected.

Note

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