QToolButton Class Reference · PyQt4 中文文檔

# QToolButton Class Reference ## [[QtGui](index.htm) module] 該QToolButton類提供了一個快速訪問按鈕，命令或選項，通常用于內部[QToolBar](qtoolbar.html)。[More...](#details) 繼承[QAbstractButton](qabstractbutton.html)。 ### 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](qtoolbar.html)。工具按鈕是一個特殊的按鈕，它提供快速訪問特定的命令或選項。相對于正常的命令按鈕，工具按鈕通常不顯示文本標籤，但顯示的圖標來代替。工具按鈕通常是創建新的時[QAction](qaction.html)實例與創建[QToolBar.addAction](qtoolbar.html#addAction)（）或現有的行動被添加到工具欄[QToolBar.addAction](qtoolbar.html#addAction)（）。它也可以構建以同樣的方式與任何其他部件的工具按鈕，并安排他們一起在布局其他部件。其中一個經典的用的工具按鈕來選擇工具，例如， “筆”在一個繪圖程序的工具。這將通過使用QToolButton作為切換按鈕（參見實施[setToggleButton](index.htm#setToggleButton)（））。 QToolButton支持自動提高。在自動模式下加注，按鈕繪制一個3D框架，只有當鼠標指向它。當使用內部的一個按鈕，該功能會自動開啟[QToolBar](qtoolbar.html)。與更改[setAutoRaise](qtoolbutton.html#autoRaise-prop)（）。工具按鈕的圖標被設置為[QIcon](qicon.html)。這使得它可以指定不同的像素映射為殘疾人和活躍的狀態。殘疾人像素圖時使用的按鈕的功能不可用。當自動提出的按鈕，因為將鼠標指針懸停在它顯示了積極的像素圖。按鈕的外觀和尺寸與可調[setToolButtonStyle](qtoolbutton.html#toolButtonStyle-prop)（）和[setIconSize](qabstractbutton.html#iconSize-prop)（）。當內部使用[QToolBar](qtoolbar.html)在[QMainWindow](qmainwindow.html)，該按鈕會自動調整以[QMainWindow](qmainwindow.html)的設置（見[QMainWindow.setToolButtonStyle](qmainwindow.html#toolButtonStyle-prop)（）和[QMainWindow.setIconSize](qmainwindow.html#iconSize-prop)（））。取而代之的圖標，工具按鈕也可以顯示一個箭頭符號，與指定的[arrowType](qtoolbutton.html#arrowType-prop)。一個工具按鈕，可以在彈出菜單中提供了更多的選擇。彈出菜單可以使用設置[setMenu](qtoolbutton.html#setMenu)（）。使用[setPopupMode](qtoolbutton.html#popupMode-prop)（）來配置可與菜單設置工具按鈕的不同模式。默認模式是DelayedPopupMode它有時被用來與“后退”按鈕，在Web瀏覽器。按下并按住該按鈕，一段時間后，彈出一個菜單顯示跳轉到可能的頁面列表。默認延遲為600毫秒，你可以用它調整[setPopupDelay](index.htm#setPopupDelay)（）。 | ![Qt Assistant's toolbar with tool buttons](https://img.kancloud.cn/8c/55/8c55385f28ae697cf5a2e09c39ea245f_253x26.png) | | Qt Assistant's toolbar contains tool buttons that are associated with actions used in other parts of the main window. | * * * ## Type Documentation ``` QToolButton.ToolButtonPopupMode ``` 描述了一個菜單應彈出的工具按鈕，有一個菜單設置，或者包含一個動作列表。 | Constant | Value | Description | | --- | --- | --- | | `QToolButton.DelayedPopup` | `0` | 按住工具按鈕一定時間后（超時是款式依賴，見[QStyle.SH_ToolButton_PopupDelay](qstyle.html#StyleHint-enum)），則顯示菜單。一個典型的應用實例是在某些Web瀏覽器的工具欄的“后退”按鈕。如果用戶點擊它時，瀏覽器只是瀏覽回到上一個頁面。如果用戶按下并保持按鈕一會兒，工具按鈕顯示包含當前歷史列表菜單 | | `QToolButton.MenuButtonPopup` | `1` | 在這種模式下，工具按鈕顯示一個特殊的箭頭來指示菜單是否存在。當該按鈕的箭頭部分被按下時顯示的菜單。 | | `QToolButton.InstantPopup` | `2` | 顯示菜單時，無延時，按下工具按鈕時。在這種模式下，該按鈕自身的動作不會被觸發。 | * * * ## Method Documentation ``` QToolButton.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個空工具按鈕與父_parent_。 ``` QToolButton.actionEvent (self, QActionEvent) ``` 從重新實現[QWidget.actionEvent](qwidget.html#actionEvent)（）。 ``` Qt.ArrowType QToolButton.arrowType (self) ``` [ ``` bool QToolButton.autoRaise (self) ``` ``` QToolButton.changeEvent (self, QEvent) ``` ](qt.html#ArrowType-enum) [從重新實現](qt.html#ArrowType-enum)[QWidget.changeEvent](qwidget.html#changeEvent)（）。 ``` QAction QToolButton.defaultAction (self) ``` [ 返回默認操作。 ](qaction.html) [**See also**](qaction.html) [setDefaultAction](qtoolbutton.html#setDefaultAction)（）。 ``` QToolButton.enterEvent (self, QEvent) ``` 從重新實現[QWidget.enterEvent](qwidget.html#enterEvent)（）。 ``` bool QToolButton.event (self, QEvent?e) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` bool QToolButton.hitButton (self, QPoint?pos) ``` 從重新實現[QAbstractButton.hitButton](qabstractbutton.html#hitButton)（）。 ``` QToolButton.initStyleOption (self, QStyleOptionToolButton?option) ``` 初始化_option_與其它的值[QToolButton](qtoolbutton.html)。當他們需要一個這種方法是有用的子類[QStyleOptionToolButton](qstyleoptiontoolbutton.html)，但不希望在所有的信息填寫自己。 **See also** [QStyleOption.initFrom](qstyleoption.html#initFrom)（）。 ``` QToolButton.leaveEvent (self, QEvent) ``` 從重新實現[QWidget.leaveEvent](qwidget.html#leaveEvent)（）。 ``` QMenu QToolButton.menu (self) ``` [ 返回，如果沒有菜單已經被定義的相關聯的菜單，或0 。 ](qmenu.html) [**See also**](qmenu.html) [setMenu](qtoolbutton.html#setMenu)（）。 ``` QSize QToolButton.minimumSizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.minimumSizeHint](qwidget.html#minimumSizeHint-prop)（）。 ``` QToolButton.mousePressEvent (self, QMouseEvent) ``` 從重新實現[QWidget.mousePressEvent](qwidget.html#mousePressEvent)（）。 ``` QToolButton.mouseReleaseEvent (self, QMouseEvent) ``` 從重新實現[QWidget.mouseReleaseEvent](qwidget.html#mouseReleaseEvent)（）。 ``` QToolButton.nextCheckState (self) ``` 從重新實現[QAbstractButton.nextCheckState](qabstractbutton.html#nextCheckState)（）。 ``` QToolButton.paintEvent (self, QPaintEvent) ``` 從重新實現[QWidget.paintEvent](qwidget.html#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_。如果一個工具按鈕有一個默認的動作時，動作定義如文本，圖標，工具提示等按鈕的屬性 ](qtoolbutton.html#ToolButtonPopupMode-enum) [**See also**](qtoolbutton.html#ToolButtonPopupMode-enum) [defaultAction](qtoolbutton.html#defaultAction)（）。 ``` QToolButton.setMenu (self, QMenu?menu) ``` 聯系人給定_menu_使用此工具按鈕。菜單將根據該按鈕的顯示[popupMode](qtoolbutton.html#popupMode-prop)。菜單的所有權不轉移到工具按鈕。 **See also** [menu](qtoolbutton.html#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) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（）。 ``` QToolButton.timerEvent (self, QTimerEvent) ``` 從重新實現[QObject.timerEvent](qobject.html#timerEvent)（）。 ``` Qt.ToolButtonStyle QToolButton.toolButtonStyle (self) ``` [ * * * ## Qt Signal Documentation ``` void triggered (QAction *) ``` 這是該信號的默認超載。這個信號被發射給定的時_action_被觸發。該操作也可與用戶界面的其他部分，如菜單項和快捷鍵相關聯。以這種方式共享行動有助于使用戶界面更一致，更是往往不那么執行工作。 ](qt.html#ToolButtonStyle-enum)