QAction Class Reference · PyQt4 中文文檔

# QAction Class Reference ## [[QtGui](index.htm) module] QAction類負責提供可插入小部件抽象的用戶界面操作。[More...](#details) 繼承[QObject](qobject.html)。通過繼承[QWidgetAction](qwidgetaction.html)。 ### Types * `enum ActionEvent { Trigger, Hover }` * `enum MenuRole { NoRole, TextHeuristicRole, ApplicationSpecificRole, AboutQtRole, ..., QuitRole }` * `enum Priority { LowPriority, NormalPriority, HighPriority }` * `enum SoftKeyRole { NoSoftKey, PositiveSoftKey, NegativeSoftKey, SelectSoftKey }` ### Methods * `__init__ (self, QObject?parent)` * `__init__ (self, QString?text, QObject?parent)` * `__init__ (self, QIcon?icon, QString?text, QObject?parent)` * `QActionGroup actionGroup (self)` * `activate (self, ActionEvent?event)` * `list-of-QGraphicsWidget associatedGraphicsWidgets (self)` * `list-of-QWidget associatedWidgets (self)` * `bool autoRepeat (self)` * `QVariant data (self)` * `bool event (self, QEvent)` * `QFont font (self)` * `hover (self)` * `QIcon icon (self)` * `QString iconText (self)` * `bool isCheckable (self)` * `bool isChecked (self)` * `bool isEnabled (self)` * `bool isIconVisibleInMenu (self)` * `bool isSeparator (self)` * `bool isVisible (self)` * `QMenu menu (self)` * `MenuRole menuRole (self)` * `QWidget parentWidget (self)` * `Priority priority (self)` * `setActionGroup (self, QActionGroup?group)` * `setAutoRepeat (self, bool)` * `setCheckable (self, bool)` * `setChecked (self, bool)` * `setData (self, QVariant?var)` * `setDisabled (self, bool?b)` * `setEnabled (self, bool)` * `setFont (self, QFont?font)` * `setIcon (self, QIcon?icon)` * `setIconText (self, QString?text)` * `setIconVisibleInMenu (self, bool?visible)` * `setMenu (self, QMenu?menu)` * `setMenuRole (self, MenuRole?menuRole)` * `setPriority (self, Priority?priority)` * `setSeparator (self, bool?b)` * `setShortcut (self, QKeySequence?shortcut)` * `setShortcutContext (self, Qt.ShortcutContext?context)` * `setShortcuts (self, list-of-QKeySequence?shortcuts)` * `setShortcuts (self, QKeySequence.StandardKey)` * `setSoftKeyRole (self, SoftKeyRole?softKeyRole)` * `setStatusTip (self, QString?statusTip)` * `setText (self, QString?text)` * `setToolTip (self, QString?tip)` * `setVisible (self, bool)` * `setWhatsThis (self, QString?what)` * `QKeySequence shortcut (self)` * `Qt.ShortcutContext shortcutContext (self)` * `list-of-QKeySequence shortcuts (self)` * `bool showStatusText (self, QWidget?widget?=?None)` * `SoftKeyRole softKeyRole (self)` * `QString statusTip (self)` * `QString text (self)` * `toggle (self)` * `QString toolTip (self)` * `trigger (self)` * `QString whatsThis (self)` ### Qt Signals * `void changed ()` * `void hovered ()` * `void toggled (bool)` * `void triggered (bool = 0)` * * * ## Detailed Description QAction類負責提供可插入小部件抽象的用戶界面操作。在實際應用中很多常見的命令可以通過菜單，工具欄按鈕和鍵盤快捷鍵來調用。由于用戶期望要以相同的方式執行的每個命令，而不管所使用的用戶界面，它表示每個命令作為一個非常有用_action_。操作可以被添加到菜單和工具欄，并且會自動使它們保持同步。例如，在一個文字處理器，如果用戶按下一個大膽的工具欄按鈕，粗體菜單項將自動進行檢查。動作可以被創建為獨立的對象，但它們也可以菜單的施工過程中產生;的[QMenu](qmenu.html)類包含用于創建適合用作菜單項行動方便的功能。一個的QAction可能包含圖標，菜單文本，快捷鍵，狀態文字， “這是什么？ ”文本和工具提示。大多數這些可以在構造函數中設置。它們也可以獨立地設置[setIcon](qaction.html#icon-prop)（）[setText](qaction.html#text-prop)（）[setIconText](qaction.html#iconText-prop)（）[setShortcut](qaction.html#shortcut-prop)（）[setStatusTip](qaction.html#statusTip-prop)（）[setWhatsThis](qaction.html#whatsThis-prop)（）和[setToolTip](qaction.html#toolTip-prop)（）。為菜單項，可以設置一個單獨的字體與[setFont](qaction.html#font-prop)（）。操作使用添加小工具[QWidget.addAction](qwidget.html#addAction)（）或[QGraphicsWidget.addAction](qgraphicswidget.html#addAction)（）。請注意，一個動作必須被添加到窗口小部件可以被使用之前，這也是真實的，當快捷方式應該是全局的（也就是[Qt.ApplicationShortcut](qt.html#ShortcutContext-enum)如[Qt.ShortcutContext](qt.html#ShortcutContext-enum)）。一次的QAction已創建它應該被添加到相關的菜單和工具欄上，然后連接到將執行的動作的插槽。例如： ``` openAct = new QAction([QIcon](qicon.html)(":/../img/open.png"), tr("&Open..."), this); openAct->setShortcuts([QKeySequence](qkeysequence.html).Open); openAct->setStatusTip(tr("Open an existing file")); connect(openAct, SIGNAL(triggered()), this, SLOT(open())); fileMenu->addAction(openAct); fileToolBar->addAction(openAct); ``` 我們建議的行動被創建為使用它們。在大多數情況下，操作窗口的孩子們將應用程序的主窗口的兒童。 * * * ## Type Documentation ``` QAction.ActionEvent ``` 該枚舉類型是調用時使用[QAction.activate](qaction.html#activate)（） | Constant | Value | Description | | --- | --- | --- | | `QAction.Trigger` | `0` | 這將導致[QAction.triggered](qaction.html#triggered)（）信號被發射。 | | `QAction.Hover` | `1` | 這將導致[QAction.hovered](qaction.html#hovered)（）信號被發射。 | ``` QAction.MenuRole ``` 這個枚舉變量描述了如何一個動作應該被移動到應用程序菜單上的Mac OS X。 | Constant | Value | Description | | --- | --- | --- | | `QAction.NoRole` | `0` | 這個動作不應該被放到應用程序菜單 | | `QAction.TextHeuristicRole` | `1` | 這個動作應該在應用程序菜單的基礎上采取行動的文本中所描述的放[QMenuBar](qmenubar.html)文檔。 | | `QAction.ApplicationSpecificRole` | `2` | 這個動作應該被放置在應用程序菜單中有一個特定的應用程序角色 | | `QAction.AboutQtRole` | `3` | 這個動作匹配處理“關于Qt ”菜單項。 | | `QAction.AboutRole` | `4` | 這個動作應該放在哪里“關于”菜單項，在應用程序菜單。菜單項的文本將被設置為“關于\u003capplication NAME\u003e ” 。該應用程序的名稱是從牽強`Info.plist`在應用程序的包文件（見[Deploying an Application on Mac OS X](index.htm)）。 | | `QAction.PreferencesRole` | `5` | 這個動作應該放在那里的“首選項... ”菜單項，在應用程序菜單。 | | `QAction.QuitRole` | `6` | 這個動作應該放在哪里Quit菜單項是在應用程序菜單。 | 設置此值只對那些在菜單欄，而不是那些菜單的子菜單的直接菜單項的效果。例如，如果你有文件菜單中的菜單欄和文件菜單中有一個子菜單，設置MenuRole在該子菜單中的操作沒有任何效果。他們將永遠不會被移動。 ``` QAction.Priority ``` 這個枚舉變量定義為在用戶界面操作的優先事項。 | Constant | Value | Description | | --- | --- | --- | | `QAction.LowPriority` | `0` | 該操作不應該被優先在用戶界面中。 | | `QAction.NormalPriority` | `128` | ? | | `QAction.HighPriority` | `256` | 該行動應優先在用戶界面。 | 這個枚舉被引入或修改的Qt 4.6 。 **See also** [priority](qaction.html#priority-prop)。 ``` QAction.SoftKeyRole ``` 這個枚舉說明如何動作應放置在軟鍵欄。目前，該枚舉只有在Symbian平臺上的效果。 | Constant | Value | Description | | --- | --- | --- | | `QAction.NoSoftKey` | `0` | 此操作不應該被用來作為一個軟鍵 | | `QAction.PositiveSoftKey` | `1` | 這個動作是用來描述一個軟鍵以積極的還是非破壞性的作用，如OK，選擇或選項。 | | `QAction.NegativeSoftKey` | `2` | 這個動作是用來描述一個軟安永具有負的或破壞性的角色作用，如取消，丟棄，或關閉。 | | `QAction.SelectSoftKey` | `3` | 這個動作是用來描述用于選擇應用程序中的特定項目或插件的作用。 | 與定義的功能鍵角色的動作才可見在軟鍵欄時，包含動作的部件具有焦點。如果沒有小工具??目前擁有焦點時，軟鍵框架將向上遍歷父控件層次結構查找包含軟鍵操作的部件。這個枚舉被引入或修改的Qt 4.6 。 * * * ## Method Documentation ``` QAction.__init__ (self, QObject?parent) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個行動_parent_。如果_parent_是一個行動小組的行動將被自動插入到組。 ``` QAction.__init__ (self, QString?text, QObject?parent) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個動作與一些_text_和_parent_。如果_parent_是一個行動小組的行動將被自動插入到組。該操作使用的一個簡化版本_text_（例如：“和菜單選項... ”變成“菜單選項” ）作為描述性文本工具按鈕。您可以通過設置特定的描述與復蓋此[setText](qaction.html#text-prop)（）。同樣的文本將被用于工具提示除非您指定使用不同的文字[setToolTip](qaction.html#toolTip-prop)（）。 ``` QAction.__init__ (self, QIcon?icon, QString?text, QObject?parent) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個動作與_icon_有的_text_和_parent_。如果_parent_是一個行動小組的行動將被自動插入到組。該操作使用的一個簡化版本_text_（例如：“和菜單選項... ”變成“菜單選項” ）作為描述性文本工具按鈕。您可以通過設置特定的描述與復蓋此[setText](qaction.html#text-prop)（）。同樣的文本將被用于工具提示除非您指定使用不同的文字[setToolTip](qaction.html#toolTip-prop)（）。 ``` QActionGroup QAction.actionGroup (self) ``` [ 返回該行動小組的這一行動。如果不采取行動組管理這個行動，那么將返回0 。 ](qactiongroup.html) [**See also**](qactiongroup.html) [QActionGroup](qactiongroup.html)和[QAction.setActionGroup](qaction.html#setActionGroup)（）。 ``` QAction.activate (self, ActionEvent?event) ``` 發送相關信號[ActionEvent](qaction.html#ActionEvent-enum) _event_。根據動作的部件使用這個API使[QAction](qaction.html)以發射信號，以及發射自己。 ``` list-of-QGraphicsWidget QAction.associatedGraphicsWidgets (self) ``` 返回部件此操作已被添加到列表。此功能被引入Qt的4.5 。 **See also** [QWidget.addAction](qwidget.html#addAction)（）和[associatedWidgets](qaction.html#associatedWidgets)（）。 ``` list-of-QWidget QAction.associatedWidgets (self) ``` 返回部件此操作已被添加到列表。這個函數中引入了Qt 4.2中。 **See also** [QWidget.addAction](qwidget.html#addAction)（）和[associatedGraphicsWidgets](qaction.html#associatedGraphicsWidgets)（）。 ``` bool QAction.autoRepeat (self) ``` ``` QVariant QAction.data (self) ``` 返回用戶數據作為在QAction.setData設置。 **See also** [setData](qaction.html#setData)（）。 ``` bool QAction.event (self, QEvent) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` QFont QAction.font (self) ``` [ ``` QAction.hover (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void hover()`。這是一個方便的插槽調用激活（哈弗）。 ](qfont.html) ``` QIcon QAction.icon (self) ``` [ ``` QString QAction.iconText (self) ``` ``` bool QAction.isCheckable (self) ``` ``` bool QAction.isChecked (self) ``` ``` bool QAction.isEnabled (self) ``` ``` bool QAction.isIconVisibleInMenu (self) ``` ``` bool QAction.isSeparator (self) ``` 返回True如果這個動作是一個分離器的動作，否則返回False 。 ](qicon.html) [**See also**](qicon.html) [QAction.setSeparator](qaction.html#setSeparator)（）。 ``` bool QAction.isVisible (self) ``` ``` QMenu QAction.menu (self) ``` [ 返回包含由這個動作菜單。包含菜單操作，可用于創建帶有子菜單的菜單項，或插入到工具欄來創建彈出式菜單的按鈕。 ](qmenu.html) [**See also**](qmenu.html) [setMenu](qaction.html#setMenu)（）和[QMenu.addAction](qmenu.html#addAction)（）。 ``` MenuRole QAction.menuRole (self) ``` [](qaction.html#MenuRole-enum) ``` QWidget QAction.parentWidget (self) ``` [ 返回父控件。 ](qwidget.html) ``` Priority QAction.priority (self) ``` [ ``` QAction.setActionGroup (self, QActionGroup?group) ``` 設置此行動組_group_。該動作將被自動添加到行動組的列表。組內的行動將是相互排斥的。 ](qaction.html#Priority-enum) [**See also**](qaction.html#Priority-enum) [QActionGroup](qactiongroup.html)和[QAction.actionGroup](qaction.html#actionGroup)（）。 ``` QAction.setAutoRepeat (self, bool) ``` ``` QAction.setCheckable (self, bool) ``` ``` QAction.setChecked (self, bool) ``` 這種方法也是一個Qt槽與C + +的簽名`void setChecked(bool)`。 ``` QAction.setData (self, QVariant?var) ``` 該行動的內部數據設置為給定_userData_。 **See also** [data](qaction.html#data)（）。 ``` QAction.setDisabled (self, bool?b) ``` 這種方法也是一個Qt槽與C + +的簽名`void setDisabled(bool)`。這是一個方便的功能為[enabled](qaction.html#enabled-prop)財產，那是非常有用的信號 - 槽連接。如果_b_是真實的動作被禁止，否則將被啟用。 ``` QAction.setEnabled (self, bool) ``` 這種方法也是一個Qt槽與C + +的簽名`void setEnabled(bool)`。 ``` QAction.setFont (self, QFont?font) ``` ``` QAction.setIcon (self, QIcon?icon) ``` ``` QAction.setIconText (self, QString?text) ``` ``` QAction.setIconVisibleInMenu (self, bool?visible) ``` ``` QAction.setMenu (self, QMenu?menu) ``` 設置包含在這個動作菜單到指定的_menu_。 **See also** [menu](qaction.html#menu)（）。 ``` QAction.setMenuRole (self, MenuRole?menuRole) ``` ``` QAction.setPriority (self, Priority?priority) ``` ``` QAction.setSeparator (self, bool?b) ``` If _b_是真的，那么這個動作將被視為分隔符。如何隔板被表示取決于它被插入到插件。在大多數情況下文本，子菜單，圖標將被忽略分隔符的行為。 **See also** [QAction.isSeparator](qaction.html#isSeparator)（）。 ``` QAction.setShortcut (self, QKeySequence?shortcut) ``` ``` QAction.setShortcutContext (self, Qt.ShortcutContext?context) ``` ``` QAction.setShortcuts (self, list-of-QKeySequence?shortcuts) ``` Sets _shortcuts_作為觸發動作的快捷鍵列表。列表中的第一個元素是主要的捷徑。這個函數中引入了Qt 4.2中。 **See also** [shortcuts](qaction.html#shortcuts)（）和[shortcut](qaction.html#shortcut-prop)。 ``` QAction.setShortcuts (self, QKeySequence.StandardKey) ``` 設置快捷方式的基礎上，一個平臺相關的清單_key_。調用此函數的結果將取決于當前運行的平臺上。請注意，一個以上的快捷方式可通過此操作分配。如果只有主快捷方式是必需的，使用setShortcut代替。這個函數中引入了Qt 4.2中。 **See also** [QKeySequence.keyBindings](qkeysequence.html#keyBindings)（）。 ``` QAction.setSoftKeyRole (self, SoftKeyRole?softKeyRole) ``` ``` QAction.setStatusTip (self, QString?statusTip) ``` ``` QAction.setText (self, QString?text) ``` ``` QAction.setToolTip (self, QString?tip) ``` ``` QAction.setVisible (self, bool) ``` 這種方法也是一個Qt槽與C + +的簽名`void setVisible(bool)`。 ``` QAction.setWhatsThis (self, QString?what) ``` ``` QKeySequence QAction.shortcut (self) ``` [](qkeysequence.html) ``` Qt.ShortcutContext QAction.shortcutContext (self) ``` [ ``` list-of-QKeySequence QAction.shortcuts (self) ``` 返回快捷鍵的列表，與主快捷鍵為列表的第一個元素。這個函數中引入了Qt 4.2中。 ](qt.html#ShortcutContext-enum) [**See also**](qt.html#ShortcutContext-enum) [setShortcuts](qaction.html#setShortcuts)（）。 ``` bool QAction.showStatusText (self, QWidget?widget?=?None) ``` 更新了相關的狀態欄_widget_通過發送一個指定[QStatusTipEvent](qstatustipevent.html)它的父控件。如果返回的事件被送往True，否則返回False 。如果指定的一個空小部件，則該事件被發送到該操作的父代。 **See also** [statusTip](qaction.html#statusTip-prop)。 ``` SoftKeyRole QAction.softKeyRole (self) ``` [ ``` QString QAction.statusTip (self) ``` ``` QString QAction.text (self) ``` ``` QAction.toggle (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void toggle()`。 ](qaction.html#SoftKeyRole-enum) [這是一個方便的功能為](qaction.html#SoftKeyRole-enum)[checked](qaction.html#checked-prop)屬性。連接到它的選中狀態更改為相反的狀態。 ``` QString QAction.toolTip (self) ``` ``` QAction.trigger (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void trigger()`。這是一個方便的插槽調用激活（觸發）。 ``` QString QAction.whatsThis (self) ``` * * * ## Qt Signal Documentation ``` void changed () ``` 這是該信號的默認超載。這個信號被發射時的動作已經改變。如果你只關心在一個給定的窗口小部件的動作，你可以觀察[QWidget.actionEvent](qwidget.html#actionEvent)（）發送與[QEvent.ActionChanged](qevent.html#Type-enum)。 **See also** [QWidget.actionEvent](qwidget.html#actionEvent)（）。 ``` void hovered () ``` 這是該信號的默認超載。這個信號被發射時的動作是由用戶突出顯示的，例如，當用戶暫停使用光標移到菜單選項，工具欄按鈕，或按下一個操作的快捷鍵組合。 **See also** [QAction.activate](qaction.html#activate)（）。 ``` void toggled (bool) ``` 這是該信號的默認超載。這個信號被發射每當一個辨認的作用改變其[isChecked](qaction.html#checked-prop)（）狀態。這可以是用戶交互的結果，或者是因為[setChecked](qaction.html#checked-prop)（）被調用。 _checked_是如果動作被選中真的，還是假的，如果動作是聽之任之。 **See also** [QAction.activate](qaction.html#activate)（）[QAction.triggered](qaction.html#triggered)（）和[checked](qaction.html#checked-prop)。 ``` void triggered (bool = 0) ``` 這是該信號的默認超載。這個信號被發射時的動作是由用戶激活的，例如，當用戶點擊一個菜單選項，工具欄按鈕，或按下一個操作的快捷鍵組合，或當[trigger](qaction.html#trigger)（）被調用。值得注意的是，它是_not_當發射[setChecked](qaction.html#checked-prop)（）或[toggle](qaction.html#toggle)（）被調用。如果動作是可復，_checked_是如果動作被選中真的，還是假的，如果動作是聽之任之。 **See also** [QAction.activate](qaction.html#activate)（）[QAction.toggled](qaction.html#toggled)（）和[checked](qaction.html#checked-prop)。