QToolBar

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

Inheritance diagram of PySide2.QtWidgets.QToolBar

Synopsis

Functions

Slots

Signals

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 Application Example

class QToolBar([parent=None])

QToolBar(title[, parent=None])

param parent

QWidget

param title

unicode

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

PySide2.QtWidgets.QToolBar.actionAt(p)
Parameters

pQPoint

Return type

QAction

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

See also

childAt()

PySide2.QtWidgets.QToolBar.actionAt(x, y)
Parameters
  • xint

  • yint

Return type

QAction

This is an overloaded function.

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

PySide2.QtWidgets.QToolBar.actionGeometry(action)
Parameters

actionQAction

Return type

QRect

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

PySide2.QtWidgets.QToolBar.actionTriggered(action)
Parameters

actionQAction

PySide2.QtWidgets.QToolBar.addAction(icon, text)
Parameters
  • iconQIcon

  • text – unicode

Return type

QAction

PySide2.QtWidgets.QToolBar.addAction(icon, text, receiver)
Parameters
  • iconQIcon

  • text – unicode

  • receiverQObject

Return type

QAction

PySide2.QtWidgets.QToolBar.addAction(text)
Parameters

text – unicode

Return type

QAction

Creates a new action with the given text . This action is added to the end of the toolbar.

PySide2.QtWidgets.QToolBar.addAction(text, receiver)
Parameters
  • text – unicode

  • receiverQObject

Return type

QAction

PySide2.QtWidgets.QToolBar.addSeparator()
Return type

QAction

Adds a separator to the end of the toolbar.

PySide2.QtWidgets.QToolBar.addWidget(widget)
Parameters

widgetQWidget

Return type

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.

See also

insertWidget()

PySide2.QtWidgets.QToolBar.allowedAreas()
Return type

ToolBarAreas

PySide2.QtWidgets.QToolBar.allowedAreasChanged(allowedAreas)
Parameters

allowedAreasToolBarAreas

PySide2.QtWidgets.QToolBar.clear()

Removes all actions from the toolbar.

See also

removeAction()

PySide2.QtWidgets.QToolBar.iconSize()
Return type

QSize

See also

setIconSize()

PySide2.QtWidgets.QToolBar.iconSizeChanged(iconSize)
Parameters

iconSizeQSize

PySide2.QtWidgets.QToolBar.initStyleOption(option)
Parameters

optionQStyleOptionToolBar

PySide2.QtWidgets.QToolBar.insertSeparator(before)
Parameters

beforeQAction

Return type

QAction

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

See also

addSeparator()

PySide2.QtWidgets.QToolBar.insertWidget(before, widget)
Parameters
Return type

QAction

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

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

See also

addWidget()

PySide2.QtWidgets.QToolBar.isAreaAllowed(area)
Parameters

areaToolBarArea

Return type

bool

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

PySide2.QtWidgets.QToolBar.isFloatable()
Return type

bool

PySide2.QtWidgets.QToolBar.isFloating()
Return type

bool

PySide2.QtWidgets.QToolBar.isMovable()
Return type

bool

PySide2.QtWidgets.QToolBar.movableChanged(movable)
Parameters

movablebool

PySide2.QtWidgets.QToolBar.orientation()
Return type

Orientation

See also

setOrientation()

PySide2.QtWidgets.QToolBar.orientationChanged(orientation)
Parameters

orientationOrientation

PySide2.QtWidgets.QToolBar.setAllowedAreas(areas)
Parameters

areasToolBarAreas

See also

allowedAreas()

PySide2.QtWidgets.QToolBar.setFloatable(floatable)
Parameters

floatablebool

See also

isFloatable()

PySide2.QtWidgets.QToolBar.setIconSize(iconSize)
Parameters

iconSizeQSize

See also

iconSize()

PySide2.QtWidgets.QToolBar.setMovable(movable)
Parameters

movablebool

See also

isMovable()

PySide2.QtWidgets.QToolBar.setOrientation(orientation)
Parameters

orientationOrientation

See also

orientation()

PySide2.QtWidgets.QToolBar.setToolButtonStyle(toolButtonStyle)
Parameters

toolButtonStyleToolButtonStyle

PySide2.QtWidgets.QToolBar.toggleViewAction()
Return type

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

text windowTitle

PySide2.QtWidgets.QToolBar.toolButtonStyle()
Return type

ToolButtonStyle

PySide2.QtWidgets.QToolBar.toolButtonStyleChanged(toolButtonStyle)
Parameters

toolButtonStyleToolButtonStyle

PySide2.QtWidgets.QToolBar.topLevelChanged(topLevel)
Parameters

topLevelbool

PySide2.QtWidgets.QToolBar.visibilityChanged(visible)
Parameters

visiblebool

PySide2.QtWidgets.QToolBar.widgetForAction(action)
Parameters

actionQAction

Return type

QWidget

Returns the widget associated with the specified action .

See also

addWidget()