class QToolBar#

QToolBar 类提供了一个可移动的面板，其中包含一组控件。更多...

Inheritance diagram of PySide6.QtWidgets.QToolBar

概要#

属性#

方法#

虚方法#

槽函数#

信号#

注意

这份文档可能包含从C++自动翻译到Python的片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译有问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建工单来通知我们。

详细介绍#

通常通过调用 addToolBar(const QString &title) 创建工具栏，但它也可以作为 QVBoxLayout 的第一个小部件添加，例如。

工具栏按钮通过添加操作来添加，可以使用 addAction() 或 insertAction()。按钮组可以用 addSeparator() 或 insertSeparator() 来分隔。如果工具栏按钮不合适，可以使用 addWidget() 或 insertWidget() 插入小部件。合适的组件例子有 QSpinBox、QDoubleSpinBox 和 QComboBox。当工具栏按钮被按下时，会触发 actionTriggered() 信号。

工具栏可以固定在特定区域（例如，窗口的顶部），也可以在工具栏区域之间移动；请参阅 setMovable()、isMovable()、allowedAreas() 和 isAreaAllowed()。

当工具栏按这种方式调整大小时，导致它太小而无法显示所有包含的项时，将在工具栏的最后出现一个扩展按钮。按下扩展按钮将弹出包含当前不适合工具栏的项的菜单。

当 QToolBar 不是 QMainWindow 的子项时，它会失去使用 addWidget() 将小部件添加到工具栏中填充扩展弹出窗口的能力。请改用通过继承 QWidgetAction 并实现 createWidget() 创建的 widget 操作。

另请参阅

QToolButton QMenu QAction

注意

属性可以直接使用，当使用from __feature__ import true_property时，或者通过访问器函数。

属性allowedAreasᅟ: Qt.ToolBarArea 的组合#

此属性保存工具栏可能放置的区域。

默认值为Qt::AllToolBarAreas。

仅当工具栏在QMainWindow中时，此属性才有意义。

另请参阅

可移动的

访问函数
属性floatableᅟ: bool#

此属性表示工具栏是否可以作为独立窗口拖放。

默认值为true。

访问函数
属性floatingᅟ: bool#

此属性表示工具栏是否是独立窗口。

默认情况下，此属性为true。

另请参阅

isWindow()

访问函数
属性iconSizeᅟ: QSize#

此属性保存工具栏中图标的大小。

默认大小由应用程序风格决定，并从PM_ToolBarIconSize 像素度量中获取。它是图标可能的最大尺寸。更小的图标不会被缩放。

访问函数
属性movableᅟ: bool#

此属性表示用户是否可以将在工具栏区域内移动工具栏，或在工具栏区域之间移动。

默认情况下，此属性为true。

仅当工具栏在QMainWindow中时，此属性才有意义。

另请参阅

allowedAreas

访问函数
属性 orientation: Qt.Orientation#

此属性保存工具栏的朝向。

默认值为 Qt::Horizontal。

当工具栏由 QMainWindow 管理时，不应使用此函数。如果您希望将已添加到主窗口的工具栏移至另一个 Qt::ToolBarArea，可以使用 addToolBar() 或 insertToolBar()。

访问函数
属性 toolButtonStyle: Qt.ToolButtonStyle#

此属性保存工具栏按钮的样式。

此属性定义了所有作为 QActions 添加的工具按钮的样式。请注意，如果您使用 addWidget() 方法添加具有 QToolButton 的按钮，它不会获得此按钮样式。

要使工具按钮的样式遵循系统设置，将此属性设置为 Qt::ToolButtonFollowStyle。在 Unix 上，将使用桌面环境中的用户设置。在其他平台上，Qt::ToolButtonFollowStyle 表示仅图标。

默认值为 Qt::ToolButtonIconOnly。

访问函数
__init__(title[, parent=None])#
参数:

使用给定的 parent 构造一个 QToolBar。

给定的窗口 title 识别工具栏，并在 QMainWindow 提供的上下文菜单中显示。

另请参阅

setWindowTitle()

__init__([parent=None])
参数:

parent – QWidget

使用给定的 parent 构造一个 QToolBar。

actionAt(p)#
参数:

p – QPoint

返回类型：

QAction

返回指针 p 处的动作。如果没有找到动作，此函数返回零。

另请参阅

childAt()

actionAt(x, y)
参数:

  • x – int

  • y – int

返回类型：

QAction

这是一个重载函数。

返回指针 x, y 处的动作。如果没有找到动作，此函数返回零。

actionGeometry(action)#
参数:

action – QAction

返回类型：

QRect

actionTriggered(action)#
参数:

action – QAction

当本工具栏中的动作被触发时发出此信号。这发生在动作的工具按钮被按下，或者在工具栏外部以某种方式触发动作的情况下。参数持有触发的 action。

addSeparator()#
返回类型：

QAction

将一个分隔符添加到工具栏的末尾。

另请参阅

insertSeparator()

addWidget(widget)#
参数:

widget – QWidget

返回类型：

QAction

将给定的 widget 添加到工具栏作为工具栏的最后一个元素。

工具栏将拥有 widget。

如果您使用此方法添加一个 QToolButton，工具栏的 Qt::ToolButtonStyle 将不予考虑。

注意

应使用 QAction::setVisible() 来更改 widget 的可见性。使用 setVisible()，show() 和 hide() 不起作用。

另请参阅

insertWidget()

allowedAreas()#
返回类型：

组合 ToolBarArea

另请参阅

setAllowedAreas()

属性 allowedAreasᅟ 的获取器。

allowedAreasChanged(allowedAreas)#
参数:

allowedAreas – 组合 ToolBarArea

当工具栏允许的位置集合发生变化时，会发射此信号。可以通过 allowedAreas 指定工具栏可以放置的新区域。

另请参阅

allowedAreas

属性 allowedAreasᅟ 的通知信号。

clear()#

从工具栏中移除所有操作。

另请参阅

removeAction()

iconSize()#
返回类型：

QSize

另请参阅

setIconSize()

属性 iconSizeᅟ 的获取器。

iconSizeChanged(iconSize)#
参数:

iconSize – QSize

当图标大小发生变化时会发射此信号。`iconSize` 参数包含工具栏新的图标大小。

另请参阅

iconSize iconSize

属性 iconSizeᅟ 的通知信号。

initStyleOption(option)#
参数:

option – QStyleOptionToolBar

insertSeparator(before)#
参数:

before – QAction

返回类型：

QAction

在工具栏中插入一个分隔符，位于与 before 动作关联的工具栏项之前。

另请参阅

addSeparator()

insertWidget(before, widget)#
参数:
返回类型：

QAction

将指定的 widget 插入与 before 动作关联的工具条项之前。

注意：您应使用 QAction::setVisible() 来更改工具条的可见性。使用 setVisible() 、 show() 和 hide() 不会工作。

另请参阅

addWidget()

isAreaAllowed(area)#
参数:

area – ToolBarArea

返回类型：

bool

如果此工具条可以在指定的 area 中停靠，则返回 true；否则返回 false。

isFloatable()#
返回类型：

bool

属性 floatableᅟ 的获取器。

isFloating()#
返回类型：

bool

属性 floatingᅟ 的获取器。

isMovable()#
返回类型：

bool

属性 movableᅟ 的获取器。

movableChanged(movable)#
参数:

movable – bool

当工具条变为可移动或固定时，会发出此信号。如果工具条可以移动，则 movable 为真；否则为假。

另请参阅

可移动的

属性 movableᅟ 的通知信号。

orientation()#
返回类型：

方向

另请参阅

setOrientation()

属性 orientationᅟ 的获取器。

orientationChanged(orientation)#
参数:

orientation – Orientation

当工具栏的方向更改时会发出此信号。参数 orientation 保存工具栏的新方向。

另请参阅

方向

属性 orientation 的通知信号。

setAllowedAreas(areas)#
参数:

areas – 组合 ToolBarArea

另请参阅

allowedAreas()

属性 allowedAreas 的设置器。

setFloatable(floatable)#
参数:

floatable – bool

另请参阅

isFloatable()

属性 floatable 的设置器。

setIconSize(iconSize)#
参数:

iconSize – QSize

另请参阅

iconSize()

属性 iconSize 的设置器。

setMovable(movable)#
参数:

movable – bool

另请参阅

isMovable()

属性 movable 的设置器。

setOrientation(orientation)#
参数:

orientation – Orientation

另请参阅

orientation()

属性 orientation 的设置器。

setToolButtonStyle(toolButtonStyle)#
参数:

toolButtonStyle – ToolButtonStyle

另请参阅

toolButtonStyle()

属性 toolButtonStyle 的设置器。

toggleViewAction()#
返回类型：

QAction

返回一个可以用来显示或隐藏此工具栏的可选操作。

操作文本设置为工具栏的窗口标题。

另请参阅

窗口标题

toolButtonStyle()#
返回类型：

工具按钮样式

另请参阅

setToolButtonStyle()

属性 toolButtonStyle 的获取器。

toolButtonStyleChanged(toolButtonStyle)#
参数:

toolButtonStyle – ToolButtonStyle

当工具按钮样式改变时，会发出此信号。参数 toolButtonStyle 表示工具栏的新工具按钮样式。

属性 toolButtonStyle 的通知信号。

topLevelChanged(topLevel)#
参数:

topLevel – bool

当 floating 属性更改时，会发出此信号。如果工具栏现在是浮动状态，则参数 topLevel 为 true；否则为 false。

另请参阅

isWindow()

visibilityChanged(visible)#
参数:

visible – bool

当工具栏变为 visible（或不可见）时，会发出此信号。这发生在小部件被隐藏或显示时。

widgetForAction(action)#
参数:

action – QAction

返回类型：

QWidget

返回与指定 action 关联的小部件。

另请参阅

addWidget()