Qt for HarmonyOS/qtohosextras doc/Bundled Embedded UI Extension Example: Difference between revisions
Fix example page conversion (QTFOROH-2307) |
Add code snippets to example pages (QTFOROH-2307) |
||
| Line 8: | Line 8: | ||
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 <code>"A"</code> and <code>"B"</code>. The underlying [https://doc.qt.io/qt-5/qwindow.html QWindow] is created up front by calling [https://doc.qt.io/qt-5/qwidget.html#winId QWidget::winId]() before the binding function is invoked. | 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 <code>"A"</code> and <code>"B"</code>. The underlying [https://doc.qt.io/qt-5/qwindow.html QWindow] is created up front by calling [https://doc.qt.io/qt-5/qwidget.html#winId QWidget::winId]() before the binding function is invoked. | ||
<syntaxhighlight lang="cpp"> | |||
QString windowAQAbilityBindingKey = "A"; | |||
auto windowA = makeBundledUiExtensionWindow(windowAQAbilityBindingKey); | |||
QtOhosExtras::setBundledAbilityAndQWindowBindingKeyForQWindow( | |||
getOrCreateUnderlyingQWindow(windowA.get()), | |||
windowAQAbilityBindingKey); | |||
</syntaxhighlight> | |||
'''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 <code>io.qt.public.bundledAbilityAndQWindowBindingKey</code> parameter is started. | '''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 <code>io.qt.public.bundledAbilityAndQWindowBindingKey</code> parameter is started. | ||
Revision as of 10:11, 16 September 2026
< Qt for HarmonyOS / qtohosextras doc
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.