Jump to content

Qt for HarmonyOS/qtohosextras doc/Bundled Embedded UI Extension Example: Difference between revisions

From Qt Wiki
Publish example source listings and restore Files lists (QTFOROH-2307)
Drop manual breadcrumb, MediaWiki renders it automatically (QTFOROH-2307)
 
Line 1: Line 1:
< [[Qt_for_HarmonyOS/qtohosextras_doc|Qt for HarmonyOS / qtohosextras doc]]
= Bundled Embedded UI Extension Example =
= Bundled Embedded UI Extension Example =



Latest revision as of 05:22, 17 September 2026

Bundled Embedded UI Extension Example

Demonstrates binding Qt windows to bundled EmbeddedUIExtensionAbility instances by key.


The example creates two identical windows, each containing a label and a button that rewrites the label text. Each window is bound to a QBundledEmbeddedUiExtensionAbility instance with QtOhosExtras::setBundledAbilityAndQWindowBindingKeyForQWindow(), using the binding keys "A" and "B". The underlying QWindow is created up front by calling QWidget::winId() before the binding function is invoked.

     QString windowAQAbilityBindingKey = "A";
     auto windowA = makeBundledUiExtensionWindow(windowAQAbilityBindingKey);
     QtOhosExtras::setBundledAbilityAndQWindowBindingKeyForQWindow(
         getOrCreateUnderlyingQWindow(windowA.get()),
         windowAQAbilityBindingKey);

Note: The bound windows must have no parent or transient parent and must not be shown by the application. A window becomes visible only when the extension ability instance whose want carries the matching io.qt.public.bundledAbilityAndQWindowBindingKey parameter is started.

Files: