class QToolButton

The QToolButton class provides a quick-access button to commands or options, usually used inside a QToolBar . More…

概述

属性

• arrowType属性 - Whether the button displays an arrow instead of a normal icon

• autoRaise属性 - Whether auto-raising is enabled or not

• popupMode属性 - Describes the way that popup menus are used with tool buttons

• toolButtonStyle属性 - Whether the tool button displays an icon only, text only, or text beside/below the icon

方法

• def __init__()

• def arrowType()

• def autoRaise()

• 定义 defaultAction()

• 定义 menu()

• 定义 popupMode()

• 定义 setArrowType()

• 定义 setAutoRaise()

• 定义 setMenu()

• 定义 setPopupMode()

• 定义 toolButtonStyle()

虚函数

• 定义 initStyleOption()

槽函数

• 定义 setDefaultAction()

• 定义 setToolButtonStyle()

• 定义 showMenu()

信号

• 定义 triggered()

注释

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

详细描述

工具按钮是一个特殊按钮，可以快速访问特定的命令或选项。与普通命令按钮相反，工具按钮通常不显示文本标签，而是显示一个图标。

工具按钮通常在创建具有addAction() 的新QAction实例时创建，或者使用addAction()将现有操作添加到工具栏中。还可以像构建任何其他小部件一样构造工具按钮，并将它们与其他小部件一起排列在布局中。

工具按钮的一个经典用法是选择工具；例如，在绘图程序中选中“笔”工具。这可以通过使用QToolButton作为切换按钮来实现（参见setCheckable()）。

QToolButton 支持自动提升。在自动提升模式下，按钮仅在鼠标悬停在其上时绘制3D框架。当按钮用于 QToolBar 内时，该功能会自动开启。可以通过 setAutoRaise() 进行修改。

工具按钮的图标使用 QIcon 设置。这使得可以为禁用状态和活动状态指定不同的像素图。当按钮的功能不可用时，使用禁用像素图。当鼠标指针悬停在它上面时，按钮被自动提升并显示活动像素图。

可以通过 setToolButtonStyle() 和 setIconSize() 调整按钮的外观和尺寸。在 QToolBar 内使用且处于 QMainWindow 时，按钮将自动调整到 QMainWindow 的设置（请参阅 setToolButtonStyle() 和 setIconSize()）。工具按钮还可以显示箭头符号，通过 arrowType 指定。

工具按钮可以在弹出菜单中提供额外的选择。可以使用 setMenu() 设置弹出菜单。使用 setPopupMode() 配置具有菜单设置的工具按钮的不同模式。默认模式是延迟弹出模式，有时用于网页浏览器中的“后退”按钮。在按住按钮一段时间后，弹出菜单将显示可以跳转的可能页面列表。超时取决于样式，请参阅 SH_ToolButton_PopupDelay。

Qt Assistant的工具条与工具按钮

Qt Assistant的工具条包含与主窗口其他部分动作相关的工具按钮。

参见

QPushButton QToolBar QMainWindow QAction

class ToolButtonPopupMode

描述了如何弹出一个菜单，用于具有菜单集或包含操作列表的工具按钮。

常量	描述
QToolButton.DelayedPopup	在按住工具按钮一段时间后（超时依赖于样式，见SH_ToolButton_PopupDelay），菜单会被显示。一个典型的应用程序示例是某些网络浏览器工具栏中的“返回”按钮。如果用户点击它，浏览器会直接浏览到上一个页面。如果用户按住按钮一段时间，工具按钮会显示包含当前历史列表的菜单。
QToolButton.MenuButtonPopup	在此模式下，工具按钮显示一个特殊的箭头以指示存在菜单。当按下按钮的箭头部分时显示菜单。
QToolButton.InstantPopup	在按下工具按钮时无延迟地显示菜单。在此模式下，按钮的自定义操作不会被触发。

注释

可以使用属性当使用 from __feature__ import true_property 时或通过访问函数 otherwise.

property arrowTypeᅟ: Qt.ArrowType

这个属性用于持有按钮是否显示一个箭头而不是一个常规图标。

这个根据QToolButton 的 QToolButton 显示箭头作为图标。

默认情况下，这个属性被设置为 Qt::NoArrow。

访问函数

• arrowType()

• setArrowType()

property autoRaiseᅟ: bool

这个属性用于持有是否启用自动提升。

默认为禁用（即false）。

当在 macOS 上使用 QMacStyle 时，此属性当前被忽略。

访问函数

• autoRaise()

• setAutoRaise()

property popupModeᅟ: QToolButton.ToolButtonPopupMode

这个属性描述了与工具按钮一起使用弹出菜单的方式。

默认情况下，这个属性被设置为 DelayedPopup。

访问函数

• popupMode()

• setPopupMode()

属性 toolButtonStyle: Qt.ToolButtonStyle

此属性保存工具按钮是否仅显示图标、仅显示文本，还是文本和图标在一旁/下方显示。

默认值为 Qt::ToolButtonIconOnly。

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

QToolButton 自动将该槽连接到其所在 QMainWindow 的相关信号。

访问函数

• toolButtonStyle()

• setToolButtonStyle()

__init__([parent=None])

参数：

parent – QWidget

构造具有父元素 parent 的空工具按钮。

arrowType()

返回类型：

ArrowType

参见

setArrowType()

属性 arrowTypeᅟ 的获取器。

autoRaise()

返回类型：

bool

参见

setAutoRaise()

属性 autoRaiseᅟ 的获取器。

defaultAction()

返回类型：

QAction

返回默认操作。

参见

setDefaultAction()

initStyleOption(option)

参数：

option – QStyleOptionToolButton

使用此 QToolButton 的值初始化 option 。此方法对于子类很有用，当它们需要 QStyleOptionToolButton 但不想自己填写所有信息时。

参见

initFrom()

menu()

返回类型：

QMenu

返回关联的菜单，或者如果没有定义菜单，则返回None。

参见

setMenu()

弹出模式popupMode()

返回类型：

工具按钮弹出模式

参见

setPopupMode()

属性popupModeᅟ的获取器。

setArrowType(type)

参数：

type – ArrowType

参见

arrowType()

属性arrowTypeᅟ的设置器。

setAutoRaise(enable)

参数：

enable – bool

参见

autoRaise()

属性autoRaiseᅟ的设置器。

setDefaultAction(arg__1)

参数：

arg__1 – QAction

将默认操作设置为action。

如果一个工具按钮有默认操作，则这个操作将定义按钮的以下属性

• 可勾选的

• 已勾选

• 可用

• 字体

• 图标

• popupMode（假定操作有菜单）

• 状态提示

• 文本

• 工具提示

• 帮助信息

其他属性，如autoRepeat，不会受到操作的影响。

参见

defaultAction()

setMenu(menu)

参数：

menu – QMenu

将给定的menu与该工具按钮关联。

菜单将根据按钮的popupMode 显示。

菜单的所有权不会转移到工具按钮。

参见

menu()

setPopupMode(mode)

参数：

mode – ToolButtonPopupMode

参见

popupMode()

属性popupModeᅟ的设置器。

setToolButtonStyle(style)

参数：

style – ToolButtonStyle

参见

toolButtonStyle()

属性 toolButtonStyleᅟ 的设置器。

showMenu()

显示（弹出）相关的弹出菜单。如果没有这样一个菜单，此函数将不执行任何操作。此函数将在弹出菜单被用户关闭之前不返回。

toolButtonStyle()

返回类型：

ToolButtonStyle

参见

setToolButtonStyle()

属性 toolButtonStyleᅟ 的获取器。

triggered(arg__1)

参数：

arg__1 – QAction

当触发给定的 action 时，将发出此信号。

此动作也可以与用户界面的其他部分相关联，例如菜单项和键盘快捷键。以这种方式共享动作有助于使用户界面更加一致，并且通常实施起来工作量更小。