Подробное описание

Класс QX11EmbedContainer предоставляет виджет контейнера XEmbed.

XEmbed - это протокол X11, который поддерживает встраивание виджета из одного приложения в другое приложение.

Контейнер XEmbed - это графическое место, которое встраивает внешний клиентский виджет. Клиентский виджет - это окно, которое встраивается в контейнер.

Когда виджет встроен и контейнер получает фокус ввода, фокус ввода передаётся виджету. Когда виджет достигает окончания цепочки фокуса ввода, фокус ввода передаётся обратно в контейнер. Активация окна, акселераторы, модальность и перетаскивание (XDND) также обрабатываются.

QX11EmbedContainer обычно используется для создания панелей или панелей инструментов, в которые внедряются апплеты, или для поглощения приложений X11. При создании панели приложения один контейнерный виджет создаётся на панели инструментов и может или поглотить другой виджет при помощи embed(), или позволить виджету XEmbed встроиться в себя. Контейнерный идентификатор окна X11, получаемый с помощью winId(), должен быть известен клиентскому виджету. После встраивания идентификатор клиентского окна может быть получен при помощи clientWinId().

В следующем примере контейнерный виджет создаётся как основной виджет. Затем вызывается приложение "playmovie", которому передаётся идентификатор окна как параметр командной строки. Программа "playmovie" - это клиентский виджет XEmbed. Виджет встраивает сам себя в контейнер, используя идентификатор окна контейнера.

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

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

     QX11EmbedContainer container;
     container.show();

     QProcess process(&container);
     QString executable(app.arguments()[1]);
     QStringList arguments;
     arguments << QString::number(container.winId());
     process.start(executable, arguments);

     int status = app.exec();
     process.close();
     return status;
 }

После встраивания клиентского виджета контейнер посылает сигнал clientIsEmbedded(). Сигнал clientClosed() посылается при закрытии виджета.

Для QX11EmbedContainer вполне возможно встраивание виджетов XEmbed из отличных от Qt инструментариев, таких как GTK+. Произвольные (не XEmbed) виджеты X11 также могут быть встроены, то в этом случае будут потеряны XEmbed-специфичные особенности, такие как активация окна и обработка фокуса ввода при его потере.

Эквивалентом QX11EmbedContainer в GTK+ является GtkSocket. Соответствующий виджет KDE 3 называется QXEmbed.