# QWidgetAction Class Reference ## [[QtGui](index.htm) module] 該QWidgetAction類擴展[QAction](qaction.html)通過插入自定義的控件到基礎的行動的容器，如工具欄的接口。[More...](#details) 繼承[QAction](qaction.html)。 ### Methods * `__init__ (self, QObject?parent)` * `list-of-QWidget createdWidgets (self)` * `QWidget createWidget (self, QWidget?parent)` * `QWidget defaultWidget (self)` * `deleteWidget (self, QWidget?widget)` * `bool event (self, QEvent)` * `bool eventFilter (self, QObject, QEvent)` * `releaseWidget (self, QWidget?widget)` * `QWidget requestWidget (self, QWidget?parent)` * `setDefaultWidget (self, QWidget?w)` * * * ## Detailed Description 該QWidgetAction類擴展[QAction](qaction.html)通過插入自定義的控件到基礎的行動的容器，如工具欄的接口。 大多數操作在一個應用程序中表示為在工具欄菜單或按鈕的項目。但有時比較復雜的部件是必要的。例如，在一個文字處理軟件的縮放操作可使用實現[QComboBox](qcombobox.html)在[QToolBar](qtoolbar.html)，呈現出各種不同的縮放級別。[QToolBar](qtoolbar.html)提供[QToolBar.insertWidget](qtoolbar.html#insertWidget)（）作為便利的功能，用于插入一個單一的部件。但是，如果你想實現在多個容器使用自定義的小部件進行可視化的操作，那么你必須繼承QWidgetAction 。 如果一個QWidgetAction被添加到例如[QToolBar](qtoolbar.html)然后[QWidgetAction.createWidget](qwidgetaction.html#createWidget)（）被調用。該函數的重新實現應該創建一個新的自定義小部件指定的父。 如果動作是從一個容器控件，然后取出[QWidgetAction.deleteWidget](qwidgetaction.html#deleteWidget)（ ）被調用先前創建的自定義窗口小部件作為參數。默認實現隱藏窗口小部件并使用它刪除[QObject.deleteLater](qobject.html#deleteLater)（ ） 。 如果你只有一個單一的自定義窗口小部件，那么你可以用它設置為默認的小工具[setDefaultWidget](qwidgetaction.html#setDefaultWidget)（ ） 。如果該操作被添加到該插件將被用于[QToolBar](qtoolbar.html)或者一般來支持QWidgetAction動作容器。如果只有一個默認插件一個QWidgetAction被添加到兩個工具欄的同時則默認插件僅示出了在操作中加入第一工具條。 QWidgetAction接管了默認的窗口小部件的所有權。 請注意，它是由小部件通過重新實現鼠標事件處理程序，并調用激活動作，例如[QAction.trigger](qaction.html#trigger)（ ） 。 **Mac OS X**：如果您添加一個Widget在Mac OS X上的應用程序的菜單欄中的菜單，小工具將被添加，它會發揮作用，但有一些限制： 1. 小部件是從重設父離開[QMenu](qmenu.html)本機菜單視圖。如果你表現出的菜單在其他地方（例如，作為一個彈出菜單） ，小部件不會在那里。 2. widget的對焦/鍵盤操作是不可能的。 3. 由于蘋果的設計，在部件上鼠標跟蹤目前不起作用。 4. 連接[triggered](qaction.html#triggered)（）信號來打開一個模態對話框會導致在Mac OS X 10.4 （已知的bug被蘋果公司承認）崩潰插槽，一個解決方法是使用一個QueuedConnection而不是DirectConnection 。 * * * ## Method Documentation ``` QWidgetAction.__init__ (self, QObject?parent) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個行動_parent_。 ``` list-of-QWidget QWidgetAction.createdWidgets (self) ``` 返回已使用該控件列表[createWidget](qwidgetaction.html#createWidget)（）和目前正在由小部件使用的行動已被添加到。 ``` QWidget QWidgetAction.createWidget (self, QWidget?parent) ``` [ 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 這個函數被調用時的動作被添加到支持自定義部件的容器控件。如果你不希望一個自定義窗口小部件被用作指定的操作的代表性_parent_窗口小部件然后0應該返回。 ](qwidget.html) [**See also**](qwidget.html) [deleteWidget](qwidgetaction.html#deleteWidget)（ ） 。 ``` QWidget QWidgetAction.defaultWidget (self) ``` [ 返回默認的小部件。 ](qwidget.html) [**See also**](qwidget.html) [setDefaultWidget](qwidgetaction.html#setDefaultWidget)（ ） 。 ``` QWidgetAction.deleteWidget (self, QWidget?widget) ``` 該_widget_說法有它的所有權轉移給Qt的。 每當行動是從一個容器控件，使用一個自定義的顯示操作刪除這個函數被調用_widget_以前使用創建[createWidget](qwidgetaction.html#createWidget)（ ） 。默認實現隱藏_widget_并用準備好刪除[QObject.deleteLater](qobject.html#deleteLater)（ ） 。 **See also** [createWidget](qwidgetaction.html#createWidget)（ ） 。 ``` bool QWidgetAction.event (self, QEvent) ``` 從重新實現[QObject.event](qobject.html#event)（ ） 。 ``` bool QWidgetAction.eventFilter (self, QObject, QEvent) ``` 從重新實現[QObject.eventFilter](qobject.html#eventFilter)（ ） 。 ``` QWidgetAction.releaseWidget (self, QWidget?widget) ``` 該_widget_爭論 指定發布_widget_。 支持行動容器部件調用此函數時，窗口小部件操作被刪除。 **See also** [requestWidget](qwidgetaction.html#requestWidget)（ ）[deleteWidget](qwidgetaction.html#deleteWidget)（）和[defaultWidget](qwidgetaction.html#defaultWidget)（ ） 。 ``` QWidget QWidgetAction.requestWidget (self, QWidget?parent) ``` [ 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 返回表示動作的部件，用給定的_parent_。 支持行動集裝箱部件可以調用這個函數來請求一個widget作為動作的視覺表現。 ](qwidget.html) [**See also**](qwidget.html) [releaseWidget](qwidgetaction.html#releaseWidget)（ ）[createWidget](qwidgetaction.html#createWidget)（）和[defaultWidget](qwidgetaction.html#defaultWidget)（ ） 。 ``` QWidgetAction.setDefaultWidget (self, QWidget?w) ``` 該_w_說法有它的所有權轉移給Qt的。 Sets _widget_是默認的小部件。所有權轉移至[QWidgetAction](qwidgetaction.html)。除非[createWidget](qwidgetaction.html#createWidget)（ ）是由一個子類重新實現當一個容器控件通過請求將Widget返回一個新插件的默認控件是用來[requestWidget](qwidgetaction.html#requestWidget)（ ） 。 **See also** [defaultWidget](qwidgetaction.html#defaultWidget)（ ） 。