QToolBar¶
Synopsis¶
Functions¶
def
actionAt
(p)def
actionAt
(x, y)def
actionGeometry
(action)def
addAction
(icon, text)def
addAction
(icon, text, receiver)def
addAction
(text)def
addAction
(text, receiver)def
addSeparator
()def
addWidget
(widget)def
allowedAreas
()def
clear
()def
iconSize
()def
initStyleOption
(option)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)
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()
orinsertAction()
. Groups of buttons can be separated usingaddSeparator()
orinsertSeparator()
. If a toolbar button is not appropriate, a widget can be inserted instead usingaddWidget()
orinsertWidget()
. Examples of suitable widgets areQSpinBox
,QDoubleSpinBox
, andQComboBox
. When a toolbar button is pressed, it emits theactionTriggered()
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()
andisAreaAllowed()
.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 aQMainWindow
, it loses the ability to populate the extension pop up with widgets added to the toolbar usingaddWidget()
. Please use widget actions created by inheritingQWidgetAction
and implementingcreateWidget()
instead.See also
- class PySide2.QtWidgets.QToolBar([parent=None])¶
PySide2.QtWidgets.QToolBar(title[, parent=None])
- param parent:
- param title:
str
Constructs a
QToolBar
with the givenparent
.Constructs a
QToolBar
with the givenparent
.The given window
title
identifies the toolbar and is shown in the context menu provided byQMainWindow
.See also
- PySide2.QtWidgets.QToolBar.actionAt(p)¶
- Parameters:
- Return type:
Returns the action at point
p
. This function returns zero if no action was found.See also
- PySide2.QtWidgets.QToolBar.actionAt(x, y)
- Parameters:
x – int
y – int
- Return type:
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:
action –
PySide2.QtWidgets.QAction
- Return type:
Returns the geometry of the toolbar item associated with the given
action
, or an invalidQRect
if no matching item is found.
- PySide2.QtWidgets.QToolBar.actionTriggered(action)¶
- Parameters:
action –
PySide2.QtWidgets.QAction
- PySide2.QtWidgets.QToolBar.addAction(icon, text)¶
- Parameters:
icon –
PySide2.QtGui.QIcon
text – str
- Return type:
- PySide2.QtWidgets.QToolBar.addAction(icon, text, receiver)
- Parameters:
icon –
PySide2.QtGui.QIcon
text – str
receiver –
PySide2.QtCore.QObject
- Return type:
- PySide2.QtWidgets.QToolBar.addAction(text)
- Parameters:
text – str
- Return type:
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 – str
receiver –
PySide2.QtCore.QObject
- Return type:
- PySide2.QtWidgets.QToolBar.addSeparator()¶
- Return type:
Adds a separator to the end of the toolbar.
See also
- PySide2.QtWidgets.QToolBar.addWidget(widget)¶
- Parameters:
widget –
PySide2.QtWidgets.QWidget
- Return type:
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’sToolButtonStyle
will not be respected.Note
You should use
setVisible()
to change the visibility of the widget. UsingsetVisible()
,show()
andhide()
does not work.See also
- PySide2.QtWidgets.QToolBar.allowedAreas()¶
- Return type:
ToolBarAreas
This property holds areas where the toolbar may be placed.
The default is
AllToolBarAreas
.This property only makes sense if the toolbar is in a
QMainWindow
.See also
movable
- PySide2.QtWidgets.QToolBar.allowedAreasChanged(allowedAreas)¶
- Parameters:
allowedAreas –
ToolBarAreas
- PySide2.QtWidgets.QToolBar.clear()¶
Removes all actions from the toolbar.
See also
- PySide2.QtWidgets.QToolBar.iconSize()¶
- Return type:
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.
- PySide2.QtWidgets.QToolBar.iconSizeChanged(iconSize)¶
- Parameters:
iconSize –
PySide2.QtCore.QSize
- PySide2.QtWidgets.QToolBar.initStyleOption(option)¶
- Parameters:
- PySide2.QtWidgets.QToolBar.insertSeparator(before)¶
- Parameters:
before –
PySide2.QtWidgets.QAction
- Return type:
Inserts a separator into the toolbar in front of the toolbar item associated with the
before
action.See also
- PySide2.QtWidgets.QToolBar.insertWidget(before, widget)¶
- Parameters:
before –
PySide2.QtWidgets.QAction
widget –
PySide2.QtWidgets.QWidget
- Return type:
Inserts the given
widget
in front of the toolbar item associated with thebefore
action.Note: You should use
setVisible()
to change the visibility of the widget. UsingsetVisible()
,show()
andhide()
does not work.See also
- PySide2.QtWidgets.QToolBar.isAreaAllowed(area)¶
- Parameters:
area –
ToolBarArea
- Return type:
bool
Returns
true
if this toolbar is dockable in the givenarea
; otherwise returnsfalse
.
- PySide2.QtWidgets.QToolBar.isFloatable()¶
- Return type:
bool
This property holds whether the toolbar can be dragged and dropped as an independent window..
The default is true.
- PySide2.QtWidgets.QToolBar.isFloating()¶
- Return type:
bool
This property holds whether the toolbar is an independent window..
By default, this property is
true
.See also
- PySide2.QtWidgets.QToolBar.isMovable()¶
- Return type:
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
- PySide2.QtWidgets.QToolBar.movableChanged(movable)¶
- Parameters:
movable – bool
- PySide2.QtWidgets.QToolBar.orientation()¶
- Return type:
This property holds orientation of the toolbar.
The default is
Horizontal
.This function should not be used when the toolbar is managed by
QMainWindow
. You can useaddToolBar()
orinsertToolBar()
if you wish to move a toolbar that is already added to a main window to anotherToolBarArea
.
- PySide2.QtWidgets.QToolBar.orientationChanged(orientation)¶
- Parameters:
orientation –
Orientation
- PySide2.QtWidgets.QToolBar.setAllowedAreas(areas)¶
- Parameters:
areas –
ToolBarAreas
This property holds areas where the toolbar may be placed.
The default is
AllToolBarAreas
.This property only makes sense if the toolbar is in a
QMainWindow
.See also
movable
- PySide2.QtWidgets.QToolBar.setFloatable(floatable)¶
- Parameters:
floatable – bool
This property holds whether the toolbar can be dragged and dropped as an independent window..
The default is true.
- PySide2.QtWidgets.QToolBar.setIconSize(iconSize)¶
- Parameters:
iconSize –
PySide2.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.
- PySide2.QtWidgets.QToolBar.setMovable(movable)¶
- Parameters:
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
- PySide2.QtWidgets.QToolBar.setOrientation(orientation)¶
- Parameters:
orientation –
Orientation
This property holds orientation of the toolbar.
The default is
Horizontal
.This function should not be used when the toolbar is managed by
QMainWindow
. You can useaddToolBar()
orinsertToolBar()
if you wish to move a toolbar that is already added to a main window to anotherToolBarArea
.
- PySide2.QtWidgets.QToolBar.setToolButtonStyle(toolButtonStyle)¶
- Parameters:
toolButtonStyle –
ToolButtonStyle
This property holds the style of toolbar buttons.
This property defines the style of all tool buttons that are added as
QAction
s. Note that if you add aQToolButton
with theaddWidget()
method, it will not get this button style.To have the style of toolbuttons follow the system settings, set this property to
ToolButtonFollowStyle
. On Unix, the user settings from the desktop environment will be used. On other platforms,ToolButtonFollowStyle
means icon only.The default is
ToolButtonIconOnly
.
- PySide2.QtWidgets.QToolBar.toggleViewAction()¶
- Return type:
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:
This property holds the style of toolbar buttons.
This property defines the style of all tool buttons that are added as
QAction
s. Note that if you add aQToolButton
with theaddWidget()
method, it will not get this button style.To have the style of toolbuttons follow the system settings, set this property to
ToolButtonFollowStyle
. On Unix, the user settings from the desktop environment will be used. On other platforms,ToolButtonFollowStyle
means icon only.The default is
ToolButtonIconOnly
.
- PySide2.QtWidgets.QToolBar.toolButtonStyleChanged(toolButtonStyle)¶
- Parameters:
toolButtonStyle –
ToolButtonStyle
- PySide2.QtWidgets.QToolBar.topLevelChanged(topLevel)¶
- Parameters:
topLevel – bool
- PySide2.QtWidgets.QToolBar.visibilityChanged(visible)¶
- Parameters:
visible – bool
- PySide2.QtWidgets.QToolBar.widgetForAction(action)¶
- Parameters:
action –
PySide2.QtWidgets.QAction
- Return type:
Returns the widget associated with the specified
action
.See also
© 2022 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.