QToolBar#

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

Inheritance diagram of PySide6.QtWidgets.QToolBar

Synopsis#

Properties#

  • allowedAreas - Areas where the toolbar may be placed

  • floatable - Whether the toolbar can be dragged and dropped as an independent window

  • floating - Whether the toolbar is an independent window

  • iconSize - Size of icons in the toolbar

  • movable - Whether the user can move the toolbar within the toolbar area, or between toolbar areas

  • orientation - Of the toolbar

  • toolButtonStyle - The style of toolbar buttons

Functions#

Virtual functions#

Slots#

Signals#

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description#

A toolbar is typically created by calling addToolBar(const QString &title) , but it can also be added as the first widget in a QVBoxLayout , for example.

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

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

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

Parameters:

Constructs a QToolBar with the given parent.

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

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property PᅟySide6.QtWidgets.QToolBar.allowedAreas: Combination of Qt.ToolBarArea#

This property holds 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

Access functions:
property PᅟySide6.QtWidgets.QToolBar.floatable: bool#

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

The default is true.

Access functions:
property PᅟySide6.QtWidgets.QToolBar.floating: bool#

This property holds whether the toolbar is an independent window..

By default, this property is true.

See also

isWindow()

Access functions:
property PᅟySide6.QtWidgets.QToolBar.iconSize: PySide6.QtCore.QSize#

This property holds size of icons in the toolbar..

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

Access functions:
property PᅟySide6.QtWidgets.QToolBar.movable: bool#

This property holds 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

Access functions:
property PᅟySide6.QtWidgets.QToolBar.orientation: Orientation#

This property holds 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 addToolBar() or insertToolBar() if you wish to move a toolbar that is already added to a main window to another Qt::ToolBarArea.

Access functions:
property PᅟySide6.QtWidgets.QToolBar.toolButtonStyle: ToolButtonStyle#

This property holds the style of toolbar buttons.

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

To have the style of toolbuttons follow the system settings, set this property to Qt::ToolButtonFollowStyle. On Unix, the user settings from the desktop environment will be used. On other platforms, Qt::ToolButtonFollowStyle means icon only.

The default is Qt::ToolButtonIconOnly.

Access functions:
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.actionAt(p)
Parameters:

pPySide6.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.actionGeometry(action)#
Parameters:

actionPySide6.QtGui.QAction

Return type:

PySide6.QtCore.QRect

PySide6.QtWidgets.QToolBar.actionTriggered(action)#
Parameters:

actionPySide6.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.

PySide6.QtWidgets.QToolBar.addWidget(widget)#
Parameters:

widgetPySide6.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 Qt::ToolButtonStyle will not be respected.

Note

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

See also

insertWidget()

PySide6.QtWidgets.QToolBar.allowedAreas()#
Return type:

Combination of Qt.ToolBarArea

Getter of property allowedAreas .

PySide6.QtWidgets.QToolBar.allowedAreasChanged(allowedAreas)#
Parameters:

allowedAreas – Combination of Qt.ToolBarArea

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

Notification signal of property allowedAreas .

PySide6.QtWidgets.QToolBar.clear()#

Removes all actions from the toolbar.

See also

removeAction()

PySide6.QtWidgets.QToolBar.iconSize()#
Return type:

PySide6.QtCore.QSize

See also

setIconSize()

Getter of property iconSize .

PySide6.QtWidgets.QToolBar.iconSizeChanged(iconSize)#
Parameters:

iconSizePySide6.QtCore.QSize

This signal is emitted when the icon size is changed. The iconSize parameter holds the toolbar’s new icon size.

See also

iconSize iconSize

Notification signal of property iconSize .

PySide6.QtWidgets.QToolBar.initStyleOption(option)#
Parameters:

optionPySide6.QtWidgets.QStyleOptionToolBar

PySide6.QtWidgets.QToolBar.insertSeparator(before)#
Parameters:

beforePySide6.QtGui.QAction

Return type:

PySide6.QtGui.QAction

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

See also

addSeparator()

PySide6.QtWidgets.QToolBar.insertWidget(before, widget)#
Parameters:
Return type:

PySide6.QtGui.QAction

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 setVisible() , show() and hide() does not work.

See also

addWidget()

PySide6.QtWidgets.QToolBar.isAreaAllowed(area)#
Parameters:

areaToolBarArea

Return type:

bool

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

PySide6.QtWidgets.QToolBar.isFloatable()#
Return type:

bool

Getter of property floatable .

PySide6.QtWidgets.QToolBar.isFloating()#
Return type:

bool

Getter of property floating .

PySide6.QtWidgets.QToolBar.isMovable()#
Return type:

bool

Getter of property movable .

PySide6.QtWidgets.QToolBar.movableChanged(movable)#
Parameters:

movable – bool

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

Notification signal of property movable .

PySide6.QtWidgets.QToolBar.orientation()#
Return type:

Orientation

See also

setOrientation()

Getter of property orientation .

PySide6.QtWidgets.QToolBar.orientationChanged(orientation)#
Parameters:

orientationOrientation

This signal is emitted when the orientation of the toolbar changes. The orientation parameter holds the toolbar’s new orientation.

See also

orientation

Notification signal of property orientation .

PySide6.QtWidgets.QToolBar.setAllowedAreas(areas)#
Parameters:

areas – Combination of Qt.ToolBarArea

See also

allowedAreas()

Setter of property allowedAreas .

PySide6.QtWidgets.QToolBar.setFloatable(floatable)#
Parameters:

floatable – bool

See also

isFloatable()

Setter of property floatable .

PySide6.QtWidgets.QToolBar.setIconSize(iconSize)#
Parameters:

iconSizePySide6.QtCore.QSize

See also

iconSize()

Setter of property iconSize .

PySide6.QtWidgets.QToolBar.setMovable(movable)#
Parameters:

movable – bool

See also

isMovable()

Setter of property movable .

PySide6.QtWidgets.QToolBar.setOrientation(orientation)#
Parameters:

orientationOrientation

See also

orientation()

Setter of property orientation .

PySide6.QtWidgets.QToolBar.setToolButtonStyle(toolButtonStyle)#
Parameters:

toolButtonStyleToolButtonStyle

Setter of property toolButtonStyle .

PySide6.QtWidgets.QToolBar.toggleViewAction()#
Return type:

PySide6.QtGui.QAction

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

windowTitle

PySide6.QtWidgets.QToolBar.toolButtonStyle()#
Return type:

ToolButtonStyle

Getter of property toolButtonStyle .

PySide6.QtWidgets.QToolBar.toolButtonStyleChanged(toolButtonStyle)#
Parameters:

toolButtonStyleToolButtonStyle

This signal is emitted when the tool button style is changed. The toolButtonStyle parameter holds the toolbar’s new tool button style.

Notification signal of property toolButtonStyle .

PySide6.QtWidgets.QToolBar.topLevelChanged(topLevel)#
Parameters:

topLevel – bool

This signal is emitted when the floating property changes. The topLevel parameter is true if the toolbar is now floating; otherwise it is false.

See also

isWindow()

PySide6.QtWidgets.QToolBar.visibilityChanged(visible)#
Parameters:

visible – bool

This signal is emitted when the toolbar becomes visible (or invisible). This happens when the widget is hidden or shown.

PySide6.QtWidgets.QToolBar.widgetForAction(action)#
Parameters:

actionPySide6.QtGui.QAction

Return type:

PySide6.QtWidgets.QWidget

Returns the widget associated with the specified action.

See also

addWidget()