Home · All Classes · Modules

QX11EmbedWidget Class Reference
^{[QtGui module]}

The QX11EmbedWidget class provides an XEmbed client widget. More...

Inherits QWidget.

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)

The widget and container can both initiate the embedding. If the widget is the initiator, the X11 window ID of the container that it wants to embed itself into must be passed to embedInto().

If the container initiates the embedding, the window ID of the embedded widget must be known. The container calls embed(), passing the window ID.

This example shows an application that embeds a QX11EmbedWidget subclass into the window whose ID is passed as a command-line argument:

 int main(int argc, char *argv[])
 {
     QApplication app(argc, argv);

     if (app.arguments().count() != 2) {
         qFatal("Error - expected window id as argument");
         return 1;
     }

     QString windowId(app.arguments()[1]);
     EmbedWidget window;
     window.embedInto(windowId.toULong());
     window.show();

     return app.exec();
 }

The problem of obtaining the window IDs is often solved by the container invoking the application that provides the widget as a separate process (as a panel invokes a docked applet), passing its window ID to the new process as a command-line argument. The new process can then call embedInto() with the container's window ID, as shown in the example code above. Similarly, the new process can report its window ID to the container through IPC, in which case the container can embed the widget.

When the widget has been embedded, it emits the signal embedded(). If it is closed by the container, the widget emits containerClosed(). If an error occurs when embedding, error() is emitted.

There are XEmbed widgets available for KDE and GTK+. The GTK+ equivalent of QX11EmbedWidget is GtkPlug. The corresponding KDE 3 widget is called QXEmbed.

Type Documentation

QX11EmbedWidget.Error

QX11EmbedWidget.__init__ (self, QWidget parent = None)

The parent argument, if not None, causes self to be owned by Qt instead of PyQt.

Constructs a QX11EmbedWidget object with the given parent.

int QX11EmbedWidget.containerWinId (self)

If the widget is embedded, returns the window ID of the container; otherwize returns 0.

QX11EmbedWidget.embedInto (self, int id)

When this function is called, the widget embeds itself into the container whose window ID is id.

Error QX11EmbedWidget.error (self)

Returns the type of error that occurred last. This is the same error code that is emitted by the error() signal.

See also Error.

bool QX11EmbedWidget.event (self, QEvent)

Reimplemented from QObject.event().

bool QX11EmbedWidget.eventFilter (self, QObject, QEvent)

QX11EmbedWidget.resizeEvent (self, QResizeEvent)

Reimplemented from QWidget.resizeEvent().

Qt Signal Documentation

void containerClosed ()

This is the default overload of this signal.

This signal is emitted by the client widget when the container closes the widget. This can happen if the container itself closes, or if the widget is rejected.

void embedded ()

This is the default overload of this signal.

This signal is emitted by the widget that has been embedded by an XEmbed container.

void error (QX11EmbedWidget::Error)

This is the default overload of this signal.

This signal is emitted if an error occurred as a result of embedding into or communicating with a container. The specified error describes the problem that occurred.

See also QX11EmbedWidget.Error.