# QX11EmbedWidget Class Reference ## [[QtGui](index.htm) module] 該QX11EmbedWidget類提供了一個XEMBED客戶端插件。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Types * `enum Error { Unknown, Internal, InvalidWindowID }` ### Methods * `__init__ (self, QWidget?parent?=?None)` * `int containerWinId (self)` * `embedInto (self, int?id)` * `Error error (self)` * `bool event (self, QEvent)` * `bool eventFilter (self, QObject, QEvent)` * `resizeEvent (self, QResizeEvent)` ### Qt Signals * `void containerClosed ()` * `void embedded ()` * `void error (QX11EmbedWidget::Error)` * * * ## Detailed Description 該QX11EmbedWidget類提供了一個XEMBED客戶端插件。 XEMBED是支持從一個應用程序中的窗口小部件的嵌入到另一個應用程序的X11協議。 一個XEMBED_client widget_是嵌入到一個窗口_container_。容器是圖形的位置嵌入（或_swallows_）外部應用程序。 QX11EmbedWidget是用于編寫小程序XEMBED或插件窗口小部件。當它已經嵌入與容器接收標籤焦點，焦點被傳遞到窗口小部件。當部件達到其焦點鏈的末端，焦點被傳遞回容器中。窗口激活，加速器的支持，模式和拖放（ XDND ）也被處理。 窗口小部件和容器可以同時發起的嵌入。如果部件是發起者，它希望將自己嵌入到容器的X11窗口的ID必須被傳遞給[embedInto](qx11embedwidget.html#embedInto)（ ） 。 如果容器發起的嵌入，嵌入的小部件的窗口ID必須是已知的。容器調用嵌入（ ） ，通過窗口ID 。 這個例子表明，嵌入了一個QX11EmbedWidget子類到其ID傳遞作為命令行參數的窗口的應用程序： ``` int main(int argc, char *argv[]) { [QApplication](qapplication.html) app(argc, argv); if (app.arguments().count() != 2) { qFatal("Error - expected window id as argument"); return 1; } [QString](qstring.html) windowId(app.arguments()[1]); EmbedWidget window; window.embedInto(windowId.toULong()); window.show(); return app.exec(); } ``` 獲取窗口ID的問題往往是由容器調用，它提供了插件的應用程序作為一個單獨的進程（如面板調用停靠的小程序） ，通過它的窗口的ID給新進程的命令行參數解決。那么新進程可以調用[embedInto](qx11embedwidget.html#embedInto)（）與容器的窗口ID ，如圖所示在上面的例子中的代碼。類似地，新方法可以通過IPC到容器報告其窗口ID ，在這種情況下，容器可以嵌入部件。 當部件已經被嵌入，它發出的信號[embedded](qx11embedwidget.html#embedded)（ ） 。如果它是由在容器關閉時，小窗口發射[containerClosed](qx11embedwidget.html#containerClosed)（ ） 。如果嵌入時出現錯誤，[error](qx11embedwidget.html#error)（）被發射。 有可用于KDE和GTK + XEMBED部件。 GTK +的當量QX11EmbedWidget是GtkPlug組件。相應的KDE 3的部件被稱為QXEmbed 。 * * * ## Type Documentation ``` QX11EmbedWidget.Error ``` | Constant | Value | Description | | --- | --- | --- | | `QX11EmbedWidget.Unknown` | `0` | 出現無法識別的錯誤。 | | `QX11EmbedWidget.InvalidWindowID` | `2` | 容器的X11窗口ID是無效的。此錯誤通常是通過傳遞一個無效的窗口ID來觸發[embedInto](qx11embedwidget.html#embedInto)（ ） 。 | * * * ## Method Documentation ``` QX11EmbedWidget.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個[QX11EmbedWidget](qx11embedwidget.html)與給定對象_parent_。 ``` int QX11EmbedWidget.containerWinId (self) ``` 如果窗口部件被嵌入時，返回該容器的窗口ID ; otherwize返回0。 ``` QX11EmbedWidget.embedInto (self, int?id) ``` 當該功能被調用時，插件本身嵌入到容器中的窗口編號是_id_。 If _id_ is _not_容器的窗口ID這個函數的行為不可預測。 ``` Error QX11EmbedWidget.error (self) ``` [ 返回上次發生錯誤的類型。這是由誤差（）信號發射相同的錯誤代碼。 ](qx11embedwidget.html#Error-enum) [**See also**](qx11embedwidget.html#Error-enum) [Error](qx11embedwidget.html#Error-enum)。 ``` bool QX11EmbedWidget.event (self, QEvent) ``` 從重新實現[QObject.event](qobject.html#event)（ ） 。 ``` bool QX11EmbedWidget.eventFilter (self, QObject, QEvent) ``` ``` QX11EmbedWidget.resizeEvent (self, QResizeEvent) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（ ） 。 * * * ## Qt Signal Documentation ``` void containerClosed () ``` 這是該信號的默認超載。 這個信號是由客戶端插件射出當容器關閉該窗口小部件。如果容器本身關閉這可能發生，或者如果控件將被拒絕。 該容器可以拒絕一個部件以任何理由，但是拒絕的最常見的原因是當試圖以嵌入一個插件到已嵌入的部件的容器。 ``` void embedded () ``` 這是該信號的默認超載。 這個信號是由已被嵌入由XEMBED容器的部件射出。 ``` void error (QX11EmbedWidget::Error) ``` 這是該信號的默認超載。 這個信號被發射，如果發生錯誤，如嵌入或與容器連通的結果。指定_error_描述發生的問題。 **See also** [QX11EmbedWidget.Error](qx11embedwidget.html#Error-enum)。