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

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

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

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

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

Инициировать встраивание может как виджет, так и контейнер. Если виджет является инициатором, то в embedInto() должен быть передан идентификатор окна X11 контейнера, в который виджет хочет себя встроить.

Если контейнер инициирует встраивание, то должен быть известен идентификатор окна встраиваемого виджета. Контейнер вызывает embed(), передавая идентификатор окна.

Этот пример показывает приложение, которое встраивает подкласс QX11EmbedWidget в окно, идентификатор которого передан как параметр командной строки:

 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();
 }

Проблема получения идентификатора окна часто решается контейнером, вызывающим приложение, которое предоставляет виджет как отдельный процесс (как панель вызывает прикреплённый апплет), передавая идентификатор окна в новый процесс как параметр командной строки. Новый процесс может вызывать embedInto() с идентификатором окна контейнера, как показано в примере выше. Кроме того, новый процесс может сообщить о своём идентификаторе окна контейнеру через IPC, в этом случае контейнер может встроить виджет.

После встраивания виджета посылается сигнал embedded(). Если виджет закрывается контейнером, то виджет посылает сигнал containerClosed(). Если при встраивании возникает ошибка, то посылается сигнал error().

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