# QX11EmbedContainer Class Reference ## [[QtGui](index.htm) module] 該QX11EmbedContainer類提供了一個XEMBED容器部件。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Types * `enum Error { Unknown, Internal, InvalidWindowID }` ### Methods * `__init__ (self, QWidget?parent?=?None)` * `int clientWinId (self)` * `discardClient (self)` * `embedClient (self, int?id)` * `Error error (self)` * `bool event (self, QEvent)` * `bool eventFilter (self, QObject, QEvent)` * `hideEvent (self, QHideEvent)` * `QSize minimumSizeHint (self)` * `paintEvent (self, QPaintEvent?e)` * `resizeEvent (self, QResizeEvent)` * `showEvent (self, QShowEvent)` ### Qt Signals * `void clientClosed ()` * `void clientIsEmbedded ()` * `void error (QX11EmbedContainer::Error)` * * * ## Detailed Description 該QX11EmbedContainer類提供了一個XEMBED容器部件。 XEMBED是支持從一個應用程序中的窗口小部件的嵌入到另一個應用程序的X11協議。 一個XEMBED_container_是圖形的位置嵌入外部_client widget_。客戶端插件是嵌入到容器中的一個窗口。 當一個部件被嵌入與容器接收標籤焦點，焦點被傳遞到窗口小部件。當部件達到其焦點鏈的末端，焦點被傳遞回容器中。窗口激活，加速器的支持，模式和拖放（ XDND ）也被處理。 QX11EmbedContainer通常用于書寫板或工具欄持有小程序，或_swallowing_X11應用程序。當寫一個面板應用程序，一個容器小部件工具欄上創建的，然后它可以吞下使用嵌入另一個控件（ ） ，或允許XEMBED小工具嵌入到自己。容器的X11窗口的ID ，這是與檢索[winId](qwidget.html#winId)（） ，然后必須知道的客戶端插件。嵌入后，客戶端的窗口ID可以檢索與[clientWinId](qx11embedcontainer.html#clientWinId)（ ） 。 在下面的例子中，一個容器控件被創建為主要部件。然后，它調用名為“ playmovie ”的應用程序，通過它的窗口ID作為命令行參數。在“ playmovie ”計劃是一個XEMBED客戶端插件。該插件嵌入自身到使用容器的窗口ID的容器。 ``` int main(int argc, char *argv[]) { [QApplication](qapplication.html) app(argc, argv); if (app.arguments().count() != 2) { qFatal("Error - expected executable path as argument"); return 1; } QX11EmbedContainer container; container.show(); [QProcess](qprocess.html) process(&container); [QString](qstring.html) executable(app.arguments()[1]); [QStringList](qstringlist.html) arguments; arguments << [QString](qstring.html).number(container.winId()); process.start(executable, arguments); int status = app.exec(); process.close(); return status; } ``` 當客戶端插件被嵌入時，容器會發出信號[clientIsEmbedded](qx11embedcontainer.html#clientIsEmbedded)（ ） 。信號[clientClosed](qx11embedcontainer.html#clientClosed)（）當一個部件被關閉射出。 這是可能的QX11EmbedContainer從工具包比其他的Qt ，比如GTK +的嵌入XEMBED部件。任意（非XEMBED ） X11的部件也可以嵌入，但XEMBED特定的功能，如窗口激活并集中處理，然后消失。 GTK +的當量QX11EmbedContainer是GtkSocket容器，另外。相應的KDE 3的部件被稱為QXEmbed 。 * * * ## Type Documentation ``` QX11EmbedContainer.Error ``` | Constant | Value | Description | | --- | --- | --- | | `QX11EmbedContainer.Unknown` | `0` | 出現無法識別的錯誤。 | | `QX11EmbedContainer.InvalidWindowID` | `2` | 容器的X11窗口ID是無效的。此錯誤通常是通過傳遞一個無效的窗口ID嵌入（ ）觸發。 | * * * ## Method Documentation ``` QX11EmbedContainer.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 創建[QX11EmbedContainer](qx11embedcontainer.html)與給定對象_parent_。 ``` int QX11EmbedContainer.clientWinId (self) ``` 如果容器有一個嵌入的控件，該函數返回客戶端的X11窗口的ID ，否則返回0 。 ``` QX11EmbedContainer.discardClient (self) ``` 分離客戶端從嵌入。客戶端會出現在桌面上的獨立窗口。 ``` QX11EmbedContainer.embedClient (self, int?id) ``` 指示容器嵌入X11窗口與窗口ID_id_。該客戶端插件將移動的容器窗口的頂部，并調整大小以適合容器。 該_id_應該是由一個啟用XEMBED應用所控制的窗口的ID，但這不是強制性的。如果_id_不屬于一個XEMBED客戶端控件，然后集中處理，活化，加速器和其他功能將無法正常工作。 ``` Error QX11EmbedContainer.error (self) ``` [ 返回所發生的最后一個錯誤。 ``` bool QX11EmbedContainer.event (self, QEvent) ``` ](qx11embedcontainer.html#Error-enum) [從重新實現](qx11embedcontainer.html#Error-enum)[QObject.event](qobject.html#event)（ ） 。 ``` bool QX11EmbedContainer.eventFilter (self, QObject, QEvent) ``` ``` QX11EmbedContainer.hideEvent (self, QHideEvent) ``` ``` QSize QX11EmbedContainer.minimumSizeHint (self) ``` [ ``` QX11EmbedContainer.paintEvent (self, QPaintEvent?e) ``` ](qsize.html) [從重新實現](qsize.html)[QWidget.paintEvent](qwidget.html#paintEvent)（ ） 。 ``` QX11EmbedContainer.resizeEvent (self, QResizeEvent) ``` ``` QX11EmbedContainer.showEvent (self, QShowEvent) ``` * * * ## Qt Signal Documentation ``` void clientClosed () ``` 這是該信號的默認超載。 這個信號是由所述容器射出的客戶端插件關閉時。 ``` void clientIsEmbedded () ``` 這是該信號的默認超載。 這個信號是由當客戶端插件已經被嵌入所述容器射出。 ``` void error (QX11EmbedContainer::Error) ``` 這是該信號的默認超載。 這個信號被發射，如果嵌入或與客戶端進行通信時發生了錯誤。指定_error_描述發生的問題。 **See also** [QX11EmbedContainer.Error](qx11embedcontainer.html#Error-enum)。