# QActionGroup Class Reference ## [[QtGui](index.htm) module] 該QActionGroup類群體訴訟在一起。[More...](#details) 繼承[QObject](qobject.html)。 ### Methods * `__init__ (self, QObject?parent)` * `list-of-QAction actions (self)` * `QAction addAction (self, QAction?a)` * `QAction addAction (self, QString?text)` * `QAction addAction (self, QIcon?icon, QString?text)` * `QAction checkedAction (self)` * `bool isEnabled (self)` * `bool isExclusive (self)` * `bool isVisible (self)` * `removeAction (self, QAction?a)` * `setDisabled (self, bool?b)` * `setEnabled (self, bool)` * `setExclusive (self, bool)` * `setVisible (self, bool)` ### Qt Signals * `void hovered (QAction *)` * `void selected (QAction *)` * `void triggered (QAction *)` * * * ## Detailed Description 該QActionGroup類群體訴訟在一起。 在某些情況下是非常有用的基[QAction](qaction.html)對象在一起。例如，如果你有一個**Left Align**動作，一**Right Align**動作，一**Justify**的動作，和一個**Center**動作，僅這些操作之一應該是活動在任何一個時間。實現這一目標的一個簡單的方法是，把行動一起在一個行動小組。 下面是一個例子（從[Menus](index.htm)為例）： ``` alignmentGroup = new QActionGroup(this); alignmentGroup->addAction(leftAlignAct); alignmentGroup->addAction(rightAlignAct); alignmentGroup->addAction(justifyAct); alignmentGroup->addAction(centerAct); leftAlignAct->setChecked(true); ``` 在這里，我們創建了一個新的動作組。由于行動組是獨家默認情況下，只有一個組中的行動是在任何一個時間檢查。  一個QActionGroup發出一個[triggered](qactiongroup.html#triggered)（ ）當選擇其行動一個信號。在一個行動組的每個動作發出的[triggered](qactiongroup.html#triggered)（ ）信號如常。 如上所述，一個動作組[exclusive](qactiongroup.html#exclusive-prop)默認情況下，它確保只有一個辨認的動作是活躍在任何一個時間。如果你想組可復動作而沒有讓他們獨有的，你可以通過調用setExclusive （假）變成排他性的。 操作可以使用被添加到一個行動小組[addAction](qactiongroup.html#addAction)（ ） ，但它通常是更方便的創建操作時指定一個組，這可以確保行動與父母自動創建。動作可以彼此進行目視分離，加入的分離器作用到基;創建一個動作，并使用[QAction](qaction.html)的[setSeparator()](qaction.html#setSeparator)功能使它被認為是分隔符。行動組添加到小部件與[QWidget.addActions](qwidget.html#addActions)（）函數。 * * * ## Method Documentation ``` QActionGroup.__init__ (self, QObject?parent) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個行動小組的_parent_對象。 該行動小組是獨家默認。呼叫setExclusive （ False）來使動作組非排他性。 ``` list-of-QAction QActionGroup.actions (self) ``` 返回該組的操作的列表。這可能是空的。 ``` QAction QActionGroup.addAction (self, QAction?a) ``` [ 該_a_說法有它的所有權轉移給Qt的。 添加_action_該組，并將其返回。 通常一個動作被添加到組與組為其父創建它，所以這個功能通常不使用。 ](qaction.html) [**See also**](qaction.html) [QAction.setActionGroup](qaction.html#setActionGroup)（ ） 。 ``` QAction QActionGroup.addAction (self, QString?text) ``` [ 創建并返回一個動作與_text_。新創建的動作是這次行動組的孩子。 通常一個動作被添加到組與組作為父母創造它，所以這個功能通常不使用。 ](qaction.html) [**See also**](qaction.html) [QAction.setActionGroup](qaction.html#setActionGroup)（ ） 。 ``` QAction QActionGroup.addAction (self, QIcon?icon, QString?text) ``` [ 創建并返回一個動作與_text_和_icon_。新創建的動作是這次行動組的孩子。 通常一個動作被添加到組與組為其父創建它，所以這個功能通常不使用。 ](qaction.html) [**See also**](qaction.html) [QAction.setActionGroup](qaction.html#setActionGroup)（ ） 。 ``` QAction QActionGroup.checkedAction (self) ``` [ 返回組，或0在當前檢查行動，如果沒有被選中。 ``` bool QActionGroup.isEnabled (self) ``` ``` bool QActionGroup.isExclusive (self) ``` ``` bool QActionGroup.isVisible (self) ``` ``` QActionGroup.removeAction (self, QAction?a) ``` 該_a_爭論 移除_action_從本組。該操作不會有任何父作為一個結果。 ](qaction.html) [**See also**](qaction.html) [QAction.setActionGroup](qaction.html#setActionGroup)（ ） 。 ``` QActionGroup.setDisabled (self, bool?b) ``` 這種方法也是一個Qt槽與C + +的簽名`void setDisabled(bool)`。 這是一個方便的功能為[enabled](qactiongroup.html#enabled-prop)財產，那是非常有用的信號 - 槽連接。如果_b_是真正的行動組被禁用，否則將被啟用。 ``` QActionGroup.setEnabled (self, bool) ``` 這種方法也是一個Qt槽與C + +的簽名`void setEnabled(bool)`。 ``` QActionGroup.setExclusive (self, bool) ``` 這種方法也是一個Qt槽與C + +的簽名`void setExclusive(bool)`。 ``` QActionGroup.setVisible (self, bool) ``` 這種方法也是一個Qt槽與C + +的簽名`void setVisible(bool)`。 * * * ## Qt Signal Documentation ``` void hovered (QAction *) ``` 這是該信號的默認超載。 這個信號被發射給定的時_action_在行動組是由用戶突出顯示的，例如，當用戶暫停使用光標移到菜單選項，工具欄按鈕，或按下一個操作的快捷鍵組合。 **See also** [QAction.activate](qaction.html#activate)（ ） 。 ``` void selected (QAction *) ``` 這是該信號的默認超載。 ``` void triggered (QAction *) ``` 這是該信號的默認超載。 這個信號被發射給定的時_action_在行動組是由用戶激活的，例如，當用戶點擊一個菜單選項，工具欄按鈕，或按下一個操作的快捷鍵組合。 連接到這個信號的命令操作。 **See also** [QAction.activate](qaction.html#activate)（ ） 。