The QXEmbed widget is a container that can embed an external X-Window. This class is part of the Qt XEmbed Extension. More...
#include <qxembed.h>
Inherits QWidget.
The QXEmbed widget is a container that can embed an external X-Window.
A QXEmbed widget serves as a container that can manage one single embedded X-window. These so-called client windows can be arbitrary QWidgets.
There are two different ways of using QXembed, from the container or from the client side. When using it from the container side, you already know the window identifier of the window that should be embedded. Simply call embed() with this identifier as parameter.
Embedding from the client side requires that the client knows the window identifier of the respective container widget. Use either embedClientIntoWindow() or the high-level wrapper processClientCmdline().
If a window has been embedded succesfully, embeddedWinId() returns its id.
Reimplement the change handler windowChanged() to catch embedding or the destruction of embedded windows. In the latter case, the container also emits a signal embeddedWindowDestroyed() for convenience.
Constructs a xembed widget.
The parent, name and f arguments are passed to the QFrame constructor.
Destructor. Cleans up the focus if necessary.
Embeds the window with the identifier w into this xembed widget.
This function is useful if the server knows about the client window that should be embedded. Often it is vice versa: the client knows about his target container. In that case, it is not necessary to call embed(). Instead, the client will call the static function embedClientIntoWindow().
See also: embeddedWinId().
[static]
A utility function for clients that embed theirselves. The widget client will be embedded in the window window. The application has to ensure that window is the handle of the window identifier of an QXEmbed widget.
See also: processClientCmdline().
Returns the window identifier of the embedded window, or 0 if no window is embedded yet.
[signal]
This signal is emitted when the embedded window has been destroyed.
See also: embeddedWinId().
[virtual protected]
Reimplimented to route the focus events to the embedded window.
Reimplemented from QWidget.
[virtual protected]
Reimplemented for internal reasons; the API is not affected.
Reimplemented from QWidget.
[virtual protected]
Reimplimented to route the focus events to the embedded window.
Reimplemented from QWidget.
[virtual protected]
Reimplimented to route the keyevents to the embedded window.
Reimplemented from QWidget.
[virtual protected]
Reimplimented to route the keyevents to the embedded window.
Reimplemented from QWidget.
[virtual]
Returns a size sufficient for one character, and scroll bars.
Reimplemented from QWidget.
[static]
A utility function for clients that embed theirselves. The widget client will be embedded in the window that is passed as
-embed
command line argument.
The function returns TRUE on sucess or FALSE if no such command line parameter is specified.
See also: embedClientIntoWindow().
[virtual protected]
Reimplimented to resize the embedded window respectively.
Reimplemented from QWidget.
[virtual protected]
Reimplimented to ensure the embedded window will be visible as well.
Reimplemented from QWidget.
[virtual]
Returns a size sufficient for the embedded window.
Reimplemented from QWidget.
[virtual]
Specifies that this widget can use additional space, and that it can survive on less than sizeHint().
Reimplemented from QWidget.
[virtual protected]
Reimplimented to route the wheel events to the embedded window.
Reimplemented from QWidget.
[virtual protected]
A change handler that indicates that the embedded window has been changed. The window handle can also be retrieved with embeddedWinId().
[protected]
Reimplemented to observe child window changes.
Search the documentation, FAQ, qt-interest archive and more (uses
www.troll.no):
This file is part of the Qt toolkit, copyright © 1995-2000 Troll Tech, all rights reserved.
Copyright © 2000 Troll Tech | Trademarks | Qt version 2.1.0 (pre-release)
|