QToolButton Class Reference

[QtGui module]

该QToolButton类提供了一个快速访问按钮，命令或选项，通常用于内部QToolBar。More…

继承QAbstractButton。

Types

  • enum ToolButtonPopupMode { DelayedPopup, MenuButtonPopup, InstantPopup }

Methods

  • __init__ (self, QWidget parent = None)
  • actionEvent (self, QActionEvent)
  • Qt.ArrowType arrowType (self)
  • bool autoRaise (self)
  • changeEvent (self, QEvent)
  • QAction defaultAction (self)
  • enterEvent (self, QEvent)
  • bool event (self, QEvent e)
  • bool hitButton (self, QPoint pos)
  • initStyleOption (self, QStyleOptionToolButton option)
  • leaveEvent (self, QEvent)
  • QMenu menu (self)
  • QSize minimumSizeHint (self)
  • mousePressEvent (self, QMouseEvent)
  • mouseReleaseEvent (self, QMouseEvent)
  • nextCheckState (self)
  • paintEvent (self, QPaintEvent)
  • ToolButtonPopupMode popupMode (self)
  • setArrowType (self, Qt.ArrowType type)
  • setAutoRaise (self, bool enable)
  • setDefaultAction (self, QAction)
  • setMenu (self, QMenu menu)
  • setPopupMode (self, ToolButtonPopupMode mode)
  • setToolButtonStyle (self, Qt.ToolButtonStyle style)
  • showMenu (self)
  • QSize sizeHint (self)
  • timerEvent (self, QTimerEvent)
  • Qt.ToolButtonStyle toolButtonStyle (self)

Qt Signals

  • void triggered (QAction *)

Detailed Description

该QToolButton类提供了一个快速访问按钮，命令或选项，通常用于内部QToolBar。

工具按钮是一个特殊的按钮，它提供快速访问特定的命令或选项。相对于正常的命令按钮，工具按钮通常不显示文本标籤，但显示的图标来代替。

工具按钮通常是创建新的时QAction实例与创建QToolBar.addAction（ ）或现有的行动被添加到工具栏QToolBar.addAction（ ） 。它也可以构建以同样的方式与任何其他部件的工具按钮，并安排他们一起在布局其他部件。

其中一个经典的用的工具按钮来选择工具，例如， “笔”在一个绘图程序的工具。这将通过使用QToolButton作为切换按钮（参见实施setToggleButton（））。

QToolButton支持自动提高。在自动模式下加注，按钮绘制一个3D框架，只有当鼠标指向它。当使用内部的一个按钮，该功能会自动开启QToolBar。与更改setAutoRaise（ ） 。

工具按钮的图标被设置为QIcon。这使得它可以指定不同的像素映射为残疾人和活跃的状态。残疾人像素图时使用的按钮的功能不可用。当自动提出的按钮，因为将鼠标指针悬停在它显示了积极的像素图。

按钮的外观和尺寸与可调setToolButtonStyle（）和setIconSize（ ） 。当内部使用QToolBar在QMainWindow，该按钮会自动调整以QMainWindow的设置（见QMainWindow.setToolButtonStyle（）和QMainWindow.setIconSize（））。取而代之的图标，工具按钮也可以显示一个箭头符号，与指定的arrowType。

一个工具按钮，可以在弹出菜单中提供了更多的选择。弹出菜单可以使用设置setMenu（ ） 。使用setPopupMode（ ）来配置可与菜单设置工具按钮的不同模式。默认模式是DelayedPopupMode它有时被用来与“后退”按钮，在Web浏览器。按下并按住该按钮，一段时间后，弹出一个菜单显示跳转到可能的页面列表。默认延迟为600毫秒，你可以用它调整setPopupDelay（ ） 。

| Qt Assistant's toolbar with tool buttons | | Qt Assistant’s toolbar contains tool buttons that are associated with actions used in other parts of the main window. |

Type Documentation

  1. QToolButton.ToolButtonPopupMode

描述了一个菜单应弹出的工具按钮，有一个菜单设置，或者包含一个动作列表。

Constant Value Description
QToolButton.DelayedPopup 0 按住工具按钮一定时间后（超时是款式依赖，见QStyle.SH_ToolButton_PopupDelay） ，则显示菜单。一个典型的应用实例是在某些Web浏览器的工具栏的“后退”按钮。如果用户点击它时，浏览器只是浏览回到上一个页面。如果用户按下并保持按钮一会儿，工具按钮显示包含当前历史列表菜单
QToolButton.MenuButtonPopup 1 在这种模式下，工具按钮显示一个特殊的箭头来指示菜单是否存在。当该按钮的箭头部分被按下时显示的菜单。
QToolButton.InstantPopup 2 显示菜单时，无延时，按下工具按钮时。在这种模式下，该按钮自身的动作不会被触发。

Method Documentation

  1. QToolButton.__init__ (self, QWidget parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个空工具按钮与父parent。

  1. QToolButton.actionEvent (self, QActionEvent)

从重新实现QWidget.actionEvent（ ） 。

  1. Qt.ArrowType QToolButton.arrowType (self)

[

  1. bool QToolButton.autoRaise (self)
  1. QToolButton.changeEvent (self, QEvent)

]($docs-qt.html#ArrowType-enum)

从重新实现QWidget.changeEvent（ ） 。

  1. QAction QToolButton.defaultAction (self)

[

返回默认操作。

]($docs-qaction.html)

See also setDefaultAction（ ） 。

  1. QToolButton.enterEvent (self, QEvent)

从重新实现QWidget.enterEvent（ ） 。

  1. bool QToolButton.event (self, QEvent e)

从重新实现QObject.event（ ） 。

  1. bool QToolButton.hitButton (self, QPoint pos)

从重新实现QAbstractButton.hitButton（ ） 。

  1. QToolButton.initStyleOption (self, QStyleOptionToolButton option)

初始化option与其它的值QToolButton。当他们需要一个这种方法是有用的子类QStyleOptionToolButton，但不希望在所有的信息填写自己。

See also QStyleOption.initFrom（ ） 。

  1. QToolButton.leaveEvent (self, QEvent)

从重新实现QWidget.leaveEvent（ ） 。

  1. QMenu QToolButton.menu (self)

[

返回，如果没有菜单已经被定义的相关联的菜单，或0 。

]($docs-qmenu.html)

See also setMenu（ ） 。

  1. QSize QToolButton.minimumSizeHint (self)

从重新实现QWidget.minimumSizeHint（ ） 。

  1. QToolButton.mousePressEvent (self, QMouseEvent)

从重新实现QWidget.mousePressEvent（ ） 。

  1. QToolButton.mouseReleaseEvent (self, QMouseEvent)

从重新实现QWidget.mouseReleaseEvent（ ） 。

  1. QToolButton.nextCheckState (self)

从重新实现QAbstractButton.nextCheckState（ ） 。

  1. QToolButton.paintEvent (self, QPaintEvent)

从重新实现QWidget.paintEvent（ ） 。

描绘按钮响应于所述涂料event。

  1. ToolButtonPopupMode QToolButton.popupMode (self)

[

  1. QToolButton.setArrowType (self, Qt.ArrowType type)
  1. QToolButton.setAutoRaise (self, bool enable)
  1. QToolButton.setDefaultAction (self, QAction)

这种方法也是一个Qt槽与C + +的签名void setDefaultAction(QAction *)。

设置默认动作action。

如果一个工具按钮有一个默认的动作时，动作定义如文本，图标，工具提示等按钮的属性

]($docs-qtoolbutton.html#ToolButtonPopupMode-enum)

See also defaultAction（ ） 。

  1. QToolButton.setMenu (self, QMenu menu)

联系人给定menu使用此工具按钮。

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

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

See also menu（ ） 。

  1. QToolButton.setPopupMode (self, ToolButtonPopupMode mode)
  1. QToolButton.setToolButtonStyle (self, Qt.ToolButtonStyle style)

这种方法也是一个Qt槽与C + +的签名void setToolButtonStyle(Qt::ToolButtonStyle)。

  1. QToolButton.showMenu (self)

这种方法也是一个Qt槽与C + +的签名void showMenu()。

显示（弹出）相关的弹出式菜单。如果没有这样的菜单，这个函数什么都不做。此函数不返回，直到弹出菜单已经被用户关闭。

  1. QSize QToolButton.sizeHint (self)

从重新实现QWidget.sizeHint（ ） 。

  1. QToolButton.timerEvent (self, QTimerEvent)

从重新实现QObject.timerEvent（ ） 。

  1. Qt.ToolButtonStyle QToolButton.toolButtonStyle (self)

[

Qt Signal Documentation

  1. void triggered (QAction *)

这是该信号的默认超载。

这个信号被发射给定的时action被触发。

该操作也可与用户界面的其他部分，如菜单项和快捷键相关联。以这种方式共享行动有助于使用户界面更一致，更是往往不那么执行工作。

](qt.html#ToolButtonStyle-enum)