XEmbed

The XEmbed component allows developers to easily run Unix/X11 programs inside their Qt application.

XEmbed is an X11 protocol that supports the embedding of a widget from one application into another application.

An XEmbed client is a window that is embedded into a container. A container is the graphical location that embeds an external client.

When a client has been embedded and the container receives tab focus, focus is passed on to the client. When the client reaches the end of his focus chain, focus is passed back to the container. Window activation, accelerator support, modality and drag and drop (XDND) are also handled.

This Qt Solutions component is for Qt 3. For Qt 4 Solutions, please visit the Qt 4 Solutions Catalog.

Documentation:

Classes

• QtXEmbedContainer
• QtXEmbedClient

• Embedder example

Tested on:

• Qt 3.3.6 / Linux / gcc
• Qt 3.3.6 / SunOS 5.9 / SunC++

Unsupported platforms:

• Windows 95
• Windows 98/ME
• Windows 2000
• Windows XP
• Mac OS X

Download Commercial Edition:

Only available for Qt Solutions license holders with a valid Support and Maintenance agreement (authentication required).

Download Open Source Edition (GPL):

Changes:

• 1.3: Improved focus handling.
• 1.3: Bugfixes.
• 1.2: QtXEmbedContainer no longer displays a red X when no client has been embedded.
• 1.2: Focus handling fixes (backported from Qt 4).
• 1.2: Major improvements in embedding non-xembed clients (backported from Qt 4). The bool parameter to embed() has been removed, as it is now unnecessary.
• 1.2: QtXEmbedContainer now respects the embedded client's minimum size hint.
• 1.1: Waits for notification from the window manager that the window is not in withdrawn state