Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

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 contains tool buttons that are associated with actions used in other parts of the main window.

Type Documentation

QToolButton.ToolButtonPopupMode

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

Method Documentation

QToolButton.__init__ (self, QWidget parent = None)

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

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

QToolButton.actionEvent (self, QActionEvent)

从重新实现QWidget.actionEvent（ ） 。

Qt.ArrowType QToolButton.arrowType (self)

bool QToolButton.autoRaise (self)

QToolButton.changeEvent (self, QEvent)

从重新实现QWidget.changeEvent（ ） 。

QAction QToolButton.defaultAction (self)

返回默认操作。

See also setDefaultAction（ ） 。

QToolButton.enterEvent (self, QEvent)

从重新实现QWidget.enterEvent（ ） 。

bool QToolButton.event (self, QEvent e)

从重新实现QObject.event（ ） 。

bool QToolButton.hitButton (self, QPoint pos)

从重新实现QAbstractButton.hitButton（ ） 。

QToolButton.initStyleOption (self, QStyleOptionToolButton option)

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

See also QStyleOption.initFrom（ ） 。

QToolButton.leaveEvent (self, QEvent)

从重新实现QWidget.leaveEvent（ ） 。

QMenu QToolButton.menu (self)

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

See also setMenu（ ） 。

QSize QToolButton.minimumSizeHint (self)

从重新实现QWidget.minimumSizeHint（ ） 。

QToolButton.mousePressEvent (self, QMouseEvent)

从重新实现QWidget.mousePressEvent（ ） 。

QToolButton.mouseReleaseEvent (self, QMouseEvent)

从重新实现QWidget.mouseReleaseEvent（ ） 。

QToolButton.nextCheckState (self)

从重新实现QAbstractButton.nextCheckState（ ） 。

QToolButton.paintEvent (self, QPaintEvent)

从重新实现QWidget.paintEvent（ ） 。

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

ToolButtonPopupMode QToolButton.popupMode (self)

QToolButton.setArrowType (self, Qt.ArrowType type)

QToolButton.setAutoRaise (self, bool enable)

QToolButton.setDefaultAction (self, QAction)

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

设置默认动作action。

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

See also defaultAction（ ） 。

QToolButton.setMenu (self, QMenu menu)

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

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

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

See also menu（ ） 。

QToolButton.setPopupMode (self, ToolButtonPopupMode mode)

QToolButton.setToolButtonStyle (self, Qt.ToolButtonStyle style)

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

QToolButton.showMenu (self)

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

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

QSize QToolButton.sizeHint (self)

从重新实现QWidget.sizeHint（ ） 。

QToolButton.timerEvent (self, QTimerEvent)

从重新实现QObject.timerEvent（ ） 。

Qt.ToolButtonStyle QToolButton.toolButtonStyle (self)

Qt Signal Documentation

void triggered (QAction *)

这是该信号的默认超载。

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

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