View source for Qtohosextras QtOhosExtras Namespace

<!-- Source: qtohosextras.html -->
<span id="qtohosextras-namespace"></span>
= QtOhosExtras Namespace =

The [[qtohosextras_Qt_Ohos_Extras_C++_Classes|QtOhosExtras]] namespace provides miscellaneous functions to aid Ohos development. [[#details|More...]]

<div class="table">

{| class="wikitable alignedsummary"
|-
| class="memItemLeft rightAlign topAlign"| Header:
| class="memItemRight bottomAlign"| <span class="preprocessor">#include </span>
|-
| class="memItemLeft rightAlign topAlign"| qmake:
| class="memItemRight bottomAlign"| QT += ohosextras
|-
| class="memItemLeft rightAlign topAlign"| Since:
| class="memItemRight bottomAlign"| Qt 5.12.12
|}


</div>


<span id="namespaces"></span>

<span id="namespaces"></span>
== Namespaces ==

<div class="table">

{| class="wikitable alignedsummary"
|-
| class="memItemLeft rightAlign topAlign"| namespace
| class="memItemRight bottomAlign"| '''[[qtohosextras_FileShare_Namespace|FileShare]]'''
|-
| class="memItemLeft rightAlign topAlign"| namespace
| class="memItemRight bottomAlign"| '''[[qtohosextras_QOhosPasteboard_Namespace|QOhosPasteboard]]'''
|-
| class="memItemLeft rightAlign topAlign"| namespace
| class="memItemRight bottomAlign"| '''[[qtohosextras_ShareKit_Namespace|ShareKit]]'''
|}


</div>
<span id="classes"></span>

<span id="classes"></span>
== Classes ==

<div class="table">

{| class="wikitable alignedsummary"
|-
| class="memItemLeft rightAlign topAlign"| class
| class="memItemRight bottomAlign"| '''[[qtohosextras_QOhosAbilityContext_Class|QOhosAbilityContext]]'''
|-
| class="memItemLeft rightAlign topAlign"| class
| class="memItemRight bottomAlign"| '''[[qtohosextras_QOhosAppContext_Class|QOhosAppContext]]'''
|-
| class="memItemLeft rightAlign topAlign"| class
| class="memItemRight bottomAlign"| '''[[qtohosextras_QOhosBundleInfo_Class|QOhosBundleInfo]]'''
|-
| class="memItemLeft rightAlign topAlign"| class
| class="memItemRight bottomAlign"| '''[[qtohosextras_QOhosOnContinueContext_Class|QOhosOnContinueContext]]'''
|-
| class="memItemLeft rightAlign topAlign"| class
| class="memItemRight bottomAlign"| '''[[qtohosextras_QOhosOpenLinkOptions_Class|QOhosOpenLinkOptions]]'''
|-
| class="memItemLeft rightAlign topAlign"| class
| class="memItemRight bottomAlign"| '''[[qtohosextras_QOhosOperationStatus_Class|QOhosOperationStatus]]'''
|-
| class="memItemLeft rightAlign topAlign"| class
| class="memItemRight bottomAlign"| '''[[qtohosextras_QOhosStartOptions_Class|QOhosStartOptions]]'''
|-
| class="memItemLeft rightAlign topAlign"| class
| class="memItemRight bottomAlign"| '''[[qtohosextras_QOhosWant_Class|QOhosWant]]'''
|-
| class="memItemLeft rightAlign topAlign"| class
| class="memItemRight bottomAlign"| '''[[qtohosextras_QOhosWantInfo_Class|QOhosWantInfo]]'''
|}


</div>
<span id="types"></span>

<span id="types"></span>
== Types ==

<div class="table">

{| class="wikitable alignedsummary"
|-
| class="memItemLeft rightAlign topAlign"| enum
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#CloseEventRootCause-enum|CloseEventRootCause]]''' { InternalClose, AbilityClose, WindowStageClose }
|-
| class="memItemLeft rightAlign topAlign"| enum
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#QOhosWantFlag-enum|QOhosWantFlag]]''' { AuthReadUriPermission, AuthWriteUriPermission, InstallOnDemand }
|-
| class="memItemLeft rightAlign topAlign"| flags
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#QOhosWantFlag-enum|QOhosWantFlags]]'''
|-
| class="memItemLeft rightAlign topAlign"| enum
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#WindowGeometryPersistenceHint-enum|WindowGeometryPersistenceHint]]''' { Disabled, Enabled, FollowSystemSetting }
|}


</div>
<span id="functions"></span>

<span id="functions"></span>
== Functions ==

<div class="table">

{| class="wikitable alignedsummary"
|-
| class="memItemLeft rightAlign topAlign"| bool
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#authorizeFilePath|authorizeFilePath]]'''(QWindow *''parentWindow'', const QString &amp;''filePath'')
|-
| class="memItemLeft rightAlign topAlign"| QSharedPointer
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#convertToOhosExtrasWantInfo|convertToOhosExtrasWantInfo]]'''(int ''wantInfo'')
|-
| class="memItemLeft rightAlign topAlign"| int
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#convertToQpaWantInfo|convertToQpaWantInfo]]'''(''QSharedPointer'')
|-
| class="memItemLeft rightAlign topAlign"| QtOhosExtras::QOhosWant
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#convertWantFromJsonObject|convertWantFromJsonObject]]'''(const QJsonObject &amp;''jsonWant'')
|-
| class="memItemLeft rightAlign topAlign"| QJsonObject
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#convertWantToJsonObject|convertWantToJsonObject]]'''(const QtOhosExtras::QOhosWant &amp;''want'')
|-
| class="memItemLeft rightAlign topAlign"| QSharedPointer
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#createOpenLinkOptions|createOpenLinkOptions]]'''()
|-
| class="memItemLeft rightAlign topAlign"| QSharedPointer
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#createStartOptions|createStartOptions]]'''()
|-
| class="memItemLeft rightAlign topAlign"| QtOhosExtras::CloseEventRootCause
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#getCloseEventRootCause|getCloseEventRootCause]]'''(QCloseEvent *''closeEvent'')
|-
| class="memItemLeft rightAlign topAlign"| bool
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#moveFileToTrash|moveFileToTrash]]'''(const QString &amp;''filePath'')
|-
| class="memItemLeft rightAlign topAlign"| const QMetaObject *
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#qt_getEnumMetaObject|qt_getEnumMetaObject]]'''(''QtOhosExtras::QOhosAppContext::ColorThemeMode'')
|-
| class="memItemLeft rightAlign topAlign"| const QMetaObject *
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#qt_getEnumMetaObject-1|qt_getEnumMetaObject]]'''(''QtOhosExtras::QOhosStartOptions::ProcessMode'')
|-
| class="memItemLeft rightAlign topAlign"| const QMetaObject *
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#qt_getEnumMetaObject-2|qt_getEnumMetaObject]]'''(''QtOhosExtras::QOhosStartOptions::StartupVisibility'')
|-
| class="memItemLeft rightAlign topAlign"| const QMetaObject *
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#qt_getEnumMetaObject-3|qt_getEnumMetaObject]]'''(''QtOhosExtras::QOhosStartOptions::WindowMode'')
|-
| class="memItemLeft rightAlign topAlign"| const QMetaObject *
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#qt_getEnumMetaObject-4|qt_getEnumMetaObject]]'''(''QtOhosExtras::QOhosStartOptions::SupportWindowMode'')
|-
| class="memItemLeft rightAlign topAlign"| const QMetaObject *
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#qt_getEnumMetaObject-5|qt_getEnumMetaObject]]'''(''QtOhosExtras::CloseEventRootCause'')
|-
| class="memItemLeft rightAlign topAlign"| const QMetaObject *
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#qt_getEnumMetaObject-6|qt_getEnumMetaObject]]'''(''QtOhosExtras::WindowGeometryPersistenceHint'')
|-
| class="memItemLeft rightAlign topAlign"| const char *
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#qt_getEnumName|qt_getEnumName]]'''(''QtOhosExtras::QOhosAppContext::ColorThemeMode'')
|-
| class="memItemLeft rightAlign topAlign"| const char *
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#qt_getEnumName-1|qt_getEnumName]]'''(''QtOhosExtras::QOhosStartOptions::ProcessMode'')
|-
| class="memItemLeft rightAlign topAlign"| const char *
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#qt_getEnumName-2|qt_getEnumName]]'''(''QtOhosExtras::QOhosStartOptions::StartupVisibility'')
|-
| class="memItemLeft rightAlign topAlign"| const char *
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#qt_getEnumName-3|qt_getEnumName]]'''(''QtOhosExtras::QOhosStartOptions::WindowMode'')
|-
| class="memItemLeft rightAlign topAlign"| const char *
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#qt_getEnumName-4|qt_getEnumName]]'''(''QtOhosExtras::QOhosStartOptions::SupportWindowMode'')
|-
| class="memItemLeft rightAlign topAlign"| const char *
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#qt_getEnumName-5|qt_getEnumName]]'''(''QtOhosExtras::CloseEventRootCause'')
|-
| class="memItemLeft rightAlign topAlign"| const char *
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#qt_getEnumName-6|qt_getEnumName]]'''(''QtOhosExtras::WindowGeometryPersistenceHint'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#requestQOhosPermissionFromUserIfNeeded|requestQOhosPermissionFromUserIfNeeded]]'''(QObject *''resultConsumerQtContext'', QWindow *''optInstanceMainWindow'', const QString &amp;''permissionName'', int ''resultConsumer'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#requestQOhosPermissionOnSettingIfNeeded|requestQOhosPermissionOnSettingIfNeeded]]'''(QObject *''resultConsumerQtContext'', QWindow *''optInstanceMainWindow'', int ''permission'', int ''resultConsumer'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#setAbilityInstanceDestroyEnabled|setAbilityInstanceDestroyEnabled]]'''(QWindow *''instanceWindow'', bool ''destroyEnabled'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#setBundledAbilityAndQWindowBindingKeyForQWindow|setBundledAbilityAndQWindowBindingKeyForQWindow]]'''(QWindow *''window'', const QString &amp;''qAbilityQWindowBindingKey'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#setMainWindowGeometryPersistenceHint|setMainWindowGeometryPersistenceHint]]'''(QtOhosExtras::WindowGeometryPersistenceHint ''geometryPersistenceHint'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#setShowWindowAsFloatWindowHint|setShowWindowAsFloatWindowHint]]'''(QWindow *''window'', bool ''showAsFloatWindow'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#setShowWindowAsFloatWindowHint-1|setShowWindowAsFloatWindowHint]]'''(QWidget *''widget'', bool ''showAsFloatWindow'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#setSurfaceBackgroundColor|setSurfaceBackgroundColor]]'''(QWindow *''window'', const QColor &amp;''color'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#setSurfaceBackgroundColor-1|setSurfaceBackgroundColor]]'''(QWidget *''widget'', const QColor &amp;''color'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#setWindowCornerRadius|setWindowCornerRadius]]'''(QWindow *''window'', double ''radius'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#setWindowCornerRadius-1|setWindowCornerRadius]]'''(QWidget *''widget'', double ''radius'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#setWindowKeepScreenOn|setWindowKeepScreenOn]]'''(QWindow *''window'', bool ''keepScreenOn'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#setWindowKeepScreenOn-1|setWindowKeepScreenOn]]'''(QWidget *''widget'', bool ''keepScreenOn'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#setWindowPrivacyMode|setWindowPrivacyMode]]'''(QWindow *''window'', bool ''privacyModeEnabled'')
|-
| class="memItemLeft rightAlign topAlign"| QSharedPointer
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#startAbility|startAbility]]'''(const QtOhosExtras::QOhosWant &amp;''want'')
|-
| class="memItemLeft rightAlign topAlign"| QSharedPointer
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#startAbility-1|startAbility]]'''(const QtOhosExtras::QOhosWant &amp;''want'', const QtOhosExtras::QOhosStartOptions &amp;''options'')
|-
| class="memItemLeft rightAlign topAlign"| QSharedPointer
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#startAbilityByType|startAbilityByType]]'''(const QString &amp;''appType'', const QJsonObject &amp;''wantParameters'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#startAppProcess|startAppProcess]]'''(const QString &amp;''processId'', const QtOhosExtras::QOhosWant &amp;''requestWant'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#startAppProcess-1|startAppProcess]]'''(const QString &amp;''processId'', const QtOhosExtras::QOhosWant &amp;''requestWant'', const QtOhosExtras::QOhosStartOptions &amp;''options'')
|-
| class="memItemLeft rightAlign topAlign"| void
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#startNewAbilityInstance|startNewAbilityInstance]]'''(QWidget *''instanceWidget'')
|-
| class="memItemLeft rightAlign topAlign"| QSharedPointer
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#tryGetNativeWindowId|tryGetNativeWindowId]]'''(QWindow *''window'')
|-
| class="memItemLeft rightAlign topAlign"| QSharedPointer
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#tryGetOnContinueData|tryGetOnContinueData]]'''(const QtOhosExtras::QOhosWant &amp;''want'')
|-
| class="memItemLeft rightAlign topAlign"| QSharedPointer
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#tryGetScreenDisplayId|tryGetScreenDisplayId]]'''(QScreen *''screen'')
|-
| class="memItemLeft rightAlign topAlign"| int
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#tryMapQOhosPermissionFromName|tryMapQOhosPermissionFromName]]'''(''const QString &amp;'')
|-
| class="memItemLeft rightAlign topAlign"| int
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#tryMapQOhosPermissionToName|tryMapQOhosPermissionToName]]'''(''int'')
|-
| class="memItemLeft rightAlign topAlign"| QFlags
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#operator-7c|operator|]]'''(QOhosWantFlags::enum_type ''f1'', QOhosWantFlags::enum_type ''f2'')
|-
| class="memItemLeft rightAlign topAlign"| QFlags
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#operator-7c-1|operator|]]'''(QOhosWantFlags::enum_type ''f1'', QFlags ''f2'')
|-
| class="memItemLeft rightAlign topAlign"| QIncompatibleFlag
| class="memItemRight bottomAlign"| '''[[qtohosextras_QtOhosExtras_Namespace#operator-7c-2|operator|]]'''(QOhosWantFlags::enum_type ''f1'', int ''f2'')
|}


</div>
<span id="details"></span>

<div class="descr">

<span id="details"></span>
== Detailed Description ==

The [[qtohosextras_Qt_Ohos_Extras_C++_Classes|QtOhosExtras]] namespace provides miscellaneous functions to aid Ohos development.


</div>
<div class="nmspace">

<span id="namespaces-1"></span>
== Namespaces ==

<span id="namespace-qtohosextrasfileshare"></span>
=== <span></span>namespace QtOhosExtras::<span class="name">FileShare</span> ===

The [[qtohosextras_FileShare_Namespace|FileShare]] to expose file permission API.

This API uses file system paths, which differ from the URIs used internally by HarmonyOS. For example, the path <code>/data/storage/el1/bundle/entry/resources/resfile/test.txt</code> will be converted to the URI <code>file://com.your.example/data/storage/el1/bundle/entry/resources/resfile/test.txt</code> , where <code>com.your.example</code> is app bundle name.

To learn more about file paths and URIs in HarmonyOS, see [https://developer.huawei.com/consumer/en/doc/harmonyos-guides-V5/app-sandbox-directory-V5 sandbox documentation].

'''Warning:''' This API relies on the underlying OHOS implementation. The following functions: [[qtohosextras_FileShare_Namespace#persistPermission|persistPermission]](), [[qtohosextras_FileShare_Namespace#revokePermission|revokePermission]](), [[qtohosextras_FileShare_Namespace#activatePermission|activatePermission]](), [[qtohosextras_FileShare_Namespace#deactivatePermission|deactivatePermission]](), and [[qtohosextras_FileShare_Namespace#checkPersistent|checkPersistent]]() may be unavailable on some devices. Additionally, there may be limitations on the maximum number of policies, and certain permissions may need to be explicitly granted to the application.

For more details and limitations, refer to the [https://developer.huawei.com/consumer/en/doc/harmonyos-guides-V14/native-fileshare-guidelines-V14 API documentation].

This namespace was introduced in Qt 5.12.12.

<span id="namespace-qtohosextrasqohospasteboard"></span>
=== <span></span>namespace QtOhosExtras::<span class="name">QOhosPasteboard</span> ===

The [[qtohosextras_QOhosPasteboard_Namespace|QOhosPasteboard]] class is to manage native pasteboard.

This namespace was introduced in Qt 5.12.12.

<span id="namespace-qtohosextrassharekit"></span>
=== <span></span>namespace QtOhosExtras::<span class="name">ShareKit</span> ===

The [[qtohosextras_ShareKit_Namespace|ShareKit]] to expose Share Kit API.

This namespace was introduced in Qt 5.12.12.


</div>
<div class="classes">

<span id="classes-1"></span>
== Classes ==

<span id="class-qohosabilitycontext"></span>
=== class [[qtohosextras_QOhosAbilityContext_Class|QOhosAbilityContext]] ===

The [[qtohosextras_QOhosAbilityContext_Class|QOhosAbilityContext]] class is to manage native UI Ability context. See [https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-inner-application-uiabilitycontext-V5 UIAbilityContext]. [[qtohosextras_QOhosAbilityContext_Class#details|More...]]

<span id="class-qohosappcontext"></span>
=== class [[qtohosextras_QOhosAppContext_Class|QOhosAppContext]] ===

The [[qtohosextras_QOhosAppContext_Class|QOhosAppContext]] class contains API to manage native application context. [[qtohosextras_QOhosAppContext_Class#details|More...]]

<span id="class-qohosbundleinfo"></span>
=== class [[qtohosextras_QOhosBundleInfo_Class|QOhosBundleInfo]] ===

The [[qtohosextras_QOhosBundleInfo_Class|QOhosBundleInfo]] class contains API to provide native application bundle info. [[qtohosextras_QOhosBundleInfo_Class#details|More...]]

<span id="class-qohosoncontinuecontext"></span>
=== class [[qtohosextras_QOhosOnContinueContext_Class|QOhosOnContinueContext]] ===

The [[qtohosextras_QOhosOnContinueContext_Class|QOhosOnContinueContext]] class manages onContinue context. It provides system data, like source application version code and set the onContinue result that is requested by the system. See [https://developer.huawei.com/consumer/en/doc/harmonyos-references-V13/js-apis-app-ability-uiability-V13#uiabilityoncontinue UIAbility onContinue]. [[qtohosextras_QOhosOnContinueContext_Class#details|More...]]

<span id="class-qohosopenlinkoptions"></span>
=== class [[qtohosextras_QOhosOpenLinkOptions_Class|QOhosOpenLinkOptions]] ===

<span id="class-qohosoperationstatus"></span>
=== class [[qtohosextras_QOhosOperationStatus_Class|QOhosOperationStatus]] ===

The [[qtohosextras_QOhosOperationStatus_Class|QOhosOperationStatus]] class provides interface to get an opertaion status. [[qtohosextras_QOhosOperationStatus_Class#details|More...]]

<span id="class-qohosstartoptions"></span>
=== class [[qtohosextras_QOhosStartOptions_Class|QOhosStartOptions]] ===

The [[qtohosextras_QOhosStartOptions_Class|QOhosStartOptions]] class is to provide new options for new started ability or process. [[qtohosextras_QOhosStartOptions_Class#details|More...]]

<span id="class-qohoswant"></span>
=== class [[qtohosextras_QOhosWant_Class|QOhosWant]] ===

[[qtohosextras_QOhosWant_Class|QOhosWant]] wraps Ohos [https://developer.huawei.com/consumer/en/doc/harmonyos-guides-V5/want-V5 Want] class. [[qtohosextras_QOhosWant_Class#details|More...]]

<span id="class-qohoswantinfo"></span>
=== class [[qtohosextras_QOhosWantInfo_Class|QOhosWantInfo]] ===

The [[qtohosextras_QOhosWantInfo_Class|QOhosWantInfo]] class is to represent Ohos want type. [[qtohosextras_QOhosWantInfo_Class#details|More...]]


</div>
<div class="types">

<span id="type-documentation"></span>
== Type Documentation ==

<span id="CloseEventRootCause-enum"></span>
=== <span id="CloseEventRootCause-enum"></span>enum QtOhosExtras::<span class="name">CloseEventRootCause</span> ===

Enumerates the close event root cause.

<div class="table">

{| class="wikitable valuelist"
|- class="odd" valign="top"
! class="tblConst"| Constant
! class="tblval"| Value
! class="tbldscr"| Description
|-
| class="topAlign"| <code>QtOhosExtras::InternalClose</code>
| class="topAlign tblval"| <code>0</code>
| class="topAlign"| Close root cause not specified or unknown.
|-
| class="topAlign"| <code>QtOhosExtras::AbilityClose</code>
| class="topAlign tblval"| <code>1</code>
| class="topAlign"| Close root cause of preparing to terminate.
|-
| class="topAlign"| <code>QtOhosExtras::WindowStageClose</code>
| class="topAlign tblval"| <code>2</code>
| class="topAlign"| Close root cause of native Window Stage or Sub-Window close.
|}


</div>
This enum was introduced or modified in Qt 5.12.12.

<span id="QOhosWantFlag-enum"></span>
=== <span id="QOhosWantFlag-enum"></span>enum QtOhosExtras::<span class="name">QOhosWantFlag</span><br />
flags QtOhosExtras::<span class="name">QOhosWantFlags</span> ===

QOhosWantFlag specifies how the Want will be handled. See [https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-ability-wantconstant-V5#flags Flags].

<div class="table">

{| class="wikitable valuelist"
|- class="odd" valign="top"
! class="tblConst"| Constant
! class="tblval"| Value
! class="tbldscr"| Description
|-
| class="topAlign"| <code>QtOhosExtras::AuthReadUriPermission</code>
| class="topAlign tblval"| <code>1 &lt;&lt; 0</code>
| class="topAlign"| Grants the permission to read the URI.
|-
| class="topAlign"| <code>QtOhosExtras::AuthWriteUriPermission</code>
| class="topAlign tblval"| <code>1 &lt;&lt; 1</code>
| class="topAlign"| Grants the permission to write data to the URI.
|-
| class="topAlign"| <code>QtOhosExtras::InstallOnDemand</code>
| class="topAlign tblval"| <code>1 &lt;&lt; 2</code>
| class="topAlign"| Ability will be installed if it has not been installed.
|}


</div>
This enum was introduced or modified in Qt 5.12.12.

The QOhosWantFlags type is a typedef for [[../qtcore/qflags.html|QFlags]]. It stores an OR combination of QOhosWantFlag values.

<span id="WindowGeometryPersistenceHint-enum"></span>
=== <span id="WindowGeometryPersistenceHint-enum"></span>enum QtOhosExtras::<span class="name">WindowGeometryPersistenceHint</span> ===

Enumerates the policy for window geometry persistence support. Specifies how a window’s geometry (the size and position) is determined when it is shown.

<div class="table">

{| class="wikitable valuelist"
|- class="odd" valign="top"
! class="tblConst"| Constant
! class="tblval"| Value
! class="tbldscr"| Description
|-
| class="topAlign"| <code>QtOhosExtras::Disabled</code>
| class="topAlign tblval"| <code>0</code>
| class="topAlign"| Use default window's geometry.
|-
| class="topAlign"| <code>QtOhosExtras::Enabled</code>
| class="topAlign tblval"| <code>1</code>
| class="topAlign"| Restore previous window's geometry (position and size when before window was closed).
|-
| class="topAlign"| <code>QtOhosExtras::FollowSystemSetting</code>
| class="topAlign tblval"| <code>2</code>
| class="topAlign"| Let the system decide whether to use <code>Disabled</code> or <code>Enabled</code> value.
|}


</div>
This enum was introduced or modified in Qt 5.12.12.


</div>
<div class="func">

<span id="function-documentation"></span>
== Function Documentation ==

<span id="authorizeFilePath"></span>
=== <span id="authorizeFilePath"></span><span class="type">bool</span> QtOhosExtras::<span class="name">authorizeFilePath</span>(<span class="type">[[../qtgui/qwindow.html|QWindow]]</span> *''parentWindow'', const <span class="type">[[../qtcore/qstring.html|QString]]</span> &amp;''filePath'') ===

Request authorization on the User selected ''parentWindow'' for a given ''filePath''. The system File Dialog in authorization mode will be presented to the User. According to User choice returns true if file path is authorized, false otherwise. See [https://developer.huawei.com/consumer/en/doc/harmonyos-references/js-apis-file-picker#documentselectoptions authMode]

This function was introduced in Qt 5.12.12.

<span id="convertToOhosExtrasWantInfo"></span>
=== convertToOhosExtrasWantInfo ===

<syntaxhighlight lang="cpp">
QSharedPointer<QtOhosExtras::QOhosWantInfo> QtOhosExtras::convertToOhosExtrasWantInfo(int ''wantInfo'')
</syntaxhighlight>

<span id="convertToQpaWantInfo"></span>
=== <span id="convertToQpaWantInfo"></span><span class="type">int</span> QtOhosExtras::<span class="name">convertToQpaWantInfo</span>(''QSharedPointer'') ===

<span id="convertWantFromJsonObject"></span>
=== <span id="convertWantFromJsonObject"></span><span class="type">[[qtohosextras_QOhosWant_Class|QtOhosExtras::QOhosWant]]</span> QtOhosExtras::<span class="name">convertWantFromJsonObject</span>(const <span class="type">[[../qtcore/qjsonobject.html|QJsonObject]]</span> &amp;''jsonWant'') ===

<span id="convertWantToJsonObject"></span>
=== <span id="convertWantToJsonObject"></span><span class="type">[[../qtcore/qjsonobject.html|QJsonObject]]</span> QtOhosExtras::<span class="name">convertWantToJsonObject</span>(const <span class="type">[[qtohosextras_QOhosWant_Class|QtOhosExtras::QOhosWant]]</span> &amp;''want'') ===

<span id="createOpenLinkOptions"></span>
=== createOpenLinkOptions ===

<syntaxhighlight lang="cpp">
QSharedPointer<QtOhosExtras::QOhosOpenLinkOptions> QtOhosExtras::createOpenLinkOptions()
</syntaxhighlight>

<span id="createStartOptions"></span>
=== createStartOptions ===

<syntaxhighlight lang="cpp">
QSharedPointer<QtOhosExtras::QOhosStartOptions> QtOhosExtras::createStartOptions()
</syntaxhighlight>

Creates [[qtohosextras_QOhosStartOptions_Class|QOhosStartOptions]] instance.

<span id="getCloseEventRootCause"></span>
=== <span id="getCloseEventRootCause"></span><span class="type">[[qtohosextras_QtOhosExtras_Namespace#CloseEventRootCause-enum|QtOhosExtras::CloseEventRootCause]]</span> QtOhosExtras::<span class="name">getCloseEventRootCause</span>(<span class="type">[[../qtgui/qcloseevent.html|QCloseEvent]]</span> *''closeEvent'') ===

Converts a given ''closeEvent'' to [[qtohosextras_QtOhosExtras_Namespace#CloseEventRootCause-enum|QtOhosExtras::CloseEventRootCause]].

Returns related [[qtohosextras_QtOhosExtras_Namespace#CloseEventRootCause-enum|QtOhosExtras::CloseEventRootCause]] value.

<span id="moveFileToTrash"></span>
=== <span id="moveFileToTrash"></span><span class="type">bool</span> QtOhosExtras::<span class="name">moveFileToTrash</span>(const <span class="type">[[../qtcore/qstring.html|QString]]</span> &amp;''filePath'') ===

Moves the file specified by ''filePath'' to the trash. Returns true if successful, false otherwise.

This function provides functionality of QFile::moveToTrash() from Qt 5.15.

<span id="qt_getEnumMetaObject"></span>
=== <span id="qt_getEnumMetaObject"></span>const <span class="type">[[../qtcore/qmetaobject.html|QMetaObject]]</span> *QtOhosExtras::<span class="name">qt_getEnumMetaObject</span>(''QtOhosExtras::QOhosAppContext::ColorThemeMode'') ===

<span id="qt_getEnumMetaObject-1"></span>
=== <span id="qt_getEnumMetaObject-1"></span>const <span class="type">[[../qtcore/qmetaobject.html|QMetaObject]]</span> *QtOhosExtras::<span class="name">qt_getEnumMetaObject</span>(''QtOhosExtras::QOhosStartOptions::ProcessMode'') ===

<span id="qt_getEnumMetaObject-2"></span>
=== <span id="qt_getEnumMetaObject-2"></span>const <span class="type">[[../qtcore/qmetaobject.html|QMetaObject]]</span> *QtOhosExtras::<span class="name">qt_getEnumMetaObject</span>(''QtOhosExtras::QOhosStartOptions::StartupVisibility'') ===

<span id="qt_getEnumMetaObject-3"></span>
=== <span id="qt_getEnumMetaObject-3"></span>const <span class="type">[[../qtcore/qmetaobject.html|QMetaObject]]</span> *QtOhosExtras::<span class="name">qt_getEnumMetaObject</span>(''QtOhosExtras::QOhosStartOptions::WindowMode'') ===

<span id="qt_getEnumMetaObject-4"></span>
=== <span id="qt_getEnumMetaObject-4"></span>const <span class="type">[[../qtcore/qmetaobject.html|QMetaObject]]</span> *QtOhosExtras::<span class="name">qt_getEnumMetaObject</span>(''QtOhosExtras::QOhosStartOptions::SupportWindowMode'') ===

<span id="qt_getEnumMetaObject-5"></span>
=== <span id="qt_getEnumMetaObject-5"></span>const <span class="type">[[../qtcore/qmetaobject.html|QMetaObject]]</span> *QtOhosExtras::<span class="name">qt_getEnumMetaObject</span>(''QtOhosExtras::CloseEventRootCause'') ===

<span id="qt_getEnumMetaObject-6"></span>
=== <span id="qt_getEnumMetaObject-6"></span>const <span class="type">[[../qtcore/qmetaobject.html|QMetaObject]]</span> *QtOhosExtras::<span class="name">qt_getEnumMetaObject</span>(''QtOhosExtras::WindowGeometryPersistenceHint'') ===

<span id="qt_getEnumName"></span>
=== <span id="qt_getEnumName"></span>const <span class="type">char</span> *QtOhosExtras::<span class="name">qt_getEnumName</span>(''QtOhosExtras::QOhosAppContext::ColorThemeMode'') ===

<span id="qt_getEnumName-1"></span>
=== <span id="qt_getEnumName-1"></span>const <span class="type">char</span> *QtOhosExtras::<span class="name">qt_getEnumName</span>(''QtOhosExtras::QOhosStartOptions::ProcessMode'') ===

<span id="qt_getEnumName-2"></span>
=== <span id="qt_getEnumName-2"></span>const <span class="type">char</span> *QtOhosExtras::<span class="name">qt_getEnumName</span>(''QtOhosExtras::QOhosStartOptions::StartupVisibility'') ===

<span id="qt_getEnumName-3"></span>
=== <span id="qt_getEnumName-3"></span>const <span class="type">char</span> *QtOhosExtras::<span class="name">qt_getEnumName</span>(''QtOhosExtras::QOhosStartOptions::WindowMode'') ===

<span id="qt_getEnumName-4"></span>
=== <span id="qt_getEnumName-4"></span>const <span class="type">char</span> *QtOhosExtras::<span class="name">qt_getEnumName</span>(''QtOhosExtras::QOhosStartOptions::SupportWindowMode'') ===

<span id="qt_getEnumName-5"></span>
=== <span id="qt_getEnumName-5"></span>const <span class="type">char</span> *QtOhosExtras::<span class="name">qt_getEnumName</span>(''QtOhosExtras::CloseEventRootCause'') ===

<span id="qt_getEnumName-6"></span>
=== <span id="qt_getEnumName-6"></span>const <span class="type">char</span> *QtOhosExtras::<span class="name">qt_getEnumName</span>(''QtOhosExtras::WindowGeometryPersistenceHint'') ===

<span id="requestQOhosPermissionFromUserIfNeeded"></span>
=== <span id="requestQOhosPermissionFromUserIfNeeded"></span><span class="type">void</span> QtOhosExtras::<span class="name">requestQOhosPermissionFromUserIfNeeded</span>(<span class="type">[[../qtcore/qobject.html|QObject]]</span> *''resultConsumerQtContext'', <span class="type">[[../qtgui/qwindow.html|QWindow]]</span> *''optInstanceMainWindow'', const <span class="type">[[../qtcore/qstring.html|QString]]</span> &amp;''permissionName'', <span class="type">int</span> ''resultConsumer'') ===

<span id="requestQOhosPermissionOnSettingIfNeeded"></span>
=== <span id="requestQOhosPermissionOnSettingIfNeeded"></span><span class="type">void</span> QtOhosExtras::<span class="name">requestQOhosPermissionOnSettingIfNeeded</span>(<span class="type">[[../qtcore/qobject.html|QObject]]</span> *''resultConsumerQtContext'', <span class="type">[[../qtgui/qwindow.html|QWindow]]</span> *''optInstanceMainWindow'', <span class="type">int</span> ''permission'', <span class="type">int</span> ''resultConsumer'') ===

<span id="setAbilityInstanceDestroyEnabled"></span>
=== <span id="setAbilityInstanceDestroyEnabled"></span><span class="type">void</span> QtOhosExtras::<span class="name">setAbilityInstanceDestroyEnabled</span>(<span class="type">[[../qtgui/qwindow.html|QWindow]]</span> *''instanceWindow'', <span class="type">bool</span> ''destroyEnabled'') ===

Sets whether the Ability related with ''instanceWindow'' can be automatically destroyed by the system when the user clicks on the window's &quot;close&quot; button. If ''destroyEnabled'' is <code>true</code>, the system destroys the Ability automatically (and Qt needs to adapt to this). If ''destroyEnabled'' = <code>false</code>, the window is not automatically destroyed, but instead standard Qt path for window close is triggered, i.e. [[../qtgui/qwindow.html#close|QWindow::close]]().

By default, the flag is set to <code>false</code>.

'''See also''' QtOhosExtras::QOhosAbilityContext::setDestroyFromSystemEnabled().

<span id="setBundledAbilityAndQWindowBindingKeyForQWindow"></span>
=== <span id="setBundledAbilityAndQWindowBindingKeyForQWindow"></span><span class="type">void</span> QtOhosExtras::<span class="name">setBundledAbilityAndQWindowBindingKeyForQWindow</span>(<span class="type">[[../qtgui/qwindow.html|QWindow]]</span> *''window'', const <span class="type">[[../qtcore/qstring.html|QString]]</span> &amp;''qAbilityQWindowBindingKey'') ===

<span id="setMainWindowGeometryPersistenceHint"></span>
=== <span id="setMainWindowGeometryPersistenceHint"></span><span class="type">void</span> QtOhosExtras::<span class="name">setMainWindowGeometryPersistenceHint</span>(<span class="type">[[qtohosextras_QtOhosExtras_Namespace#WindowGeometryPersistenceHint-enum|QtOhosExtras::WindowGeometryPersistenceHint]]</span> ''geometryPersistenceHint'') ===

Sets a given ''geometryPersistenceHint'' on first main window shown.

If this function is called with ''geometryPersistenceHint'' `Enabled`, the first main window's geometry will be saved when the window is closed and restored on the next application launch. By default this feature is disabled.

This method must be called before first main window is shown. Otherwise geometry persistence policy will not be updated.

Only supported on 2-in-1 devices.

Read about details in [https://developer.huawei.com/consumer/en/doc/harmonyos-references/js-apis-window#setwindowrectautosave here].

<span id="setShowWindowAsFloatWindowHint"></span>
=== <span id="setShowWindowAsFloatWindowHint"></span><span class="type">void</span> QtOhosExtras::<span class="name">setShowWindowAsFloatWindowHint</span>(<span class="type">[[../qtgui/qwindow.html|QWindow]]</span> *''window'', <span class="type">bool</span> ''showAsFloatWindow'') ===

Sets or unsets a given ''window'' as floating window according to ''showAsFloatWindow'' flag. Read more about floating window type [https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-window-V5 here].

<syntaxhighlight lang="cpp">
 auto window = std::make_unique<MainWindow>();
 QtOhosExtras::setShowWindowAsFloatWindowHint(window.get(), true);
 window->show();</syntaxhighlight>
<span id="setShowWindowAsFloatWindowHint-1"></span>
=== <span id="setShowWindowAsFloatWindowHint-1"></span><span class="type">void</span> QtOhosExtras::<span class="name">setShowWindowAsFloatWindowHint</span>(<span class="type">[[../qtwidgets/qwidget.html|QWidget]]</span> *''widget'', <span class="type">bool</span> ''showAsFloatWindow'') ===

Sets or unsets a given ''widget'' as floating window according to ''showAsFloatWindow'' flag. Read more about floating window type [https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-window-V5 here].

<span id="setSurfaceBackgroundColor"></span>
=== <span id="setSurfaceBackgroundColor"></span><span class="type">void</span> QtOhosExtras::<span class="name">setSurfaceBackgroundColor</span>(<span class="type">[[../qtgui/qwindow.html|QWindow]]</span> *''window'', const <span class="type">[[../qtgui/qcolor.html|QColor]]</span> &amp;''color'') ===

Sets a given ''color'' as background color on the ''window'' inner native layer.

<span id="setSurfaceBackgroundColor-1"></span>
=== <span id="setSurfaceBackgroundColor-1"></span><span class="type">void</span> QtOhosExtras::<span class="name">setSurfaceBackgroundColor</span>(<span class="type">[[../qtwidgets/qwidget.html|QWidget]]</span> *''widget'', const <span class="type">[[../qtgui/qcolor.html|QColor]]</span> &amp;''color'') ===

Sets a given ''color'' as background color on the ''widget'' inner native layer.

'''Warning:''' Currently, dynamic color change on a widget is not supported yet.

<span id="setWindowCornerRadius"></span>
=== <span id="setWindowCornerRadius"></span><span class="type">void</span> QtOhosExtras::<span class="name">setWindowCornerRadius</span>(<span class="type">[[../qtgui/qwindow.html|QWindow]]</span> *''window'', <span class="type">double</span> ''radius'') ===

Sets corner ''radius'' for a ''window''. Given ''window'' has to be a sub or floating window type. It can be achieved for example: - by setting [[../qtcore/qt.html#WindowType-enum|Qt::WindowFlags]], like: [[../qtcore/qt.html#WindowType-enum|Qt::Window]], [[../qtcore/qt.html#WindowType-enum|Qt::Popup]], [[../qtcore/qt.html#WindowType-enum|Qt::Dialog]] etc. - explicitly using QtOhosExtras::setShowWindowAsFloatWindowHint() function. More on windows in: [https://doc.qt.io/archives/qt-5.15/qwindow.html Qt official docs]. The ''radius'' must not be a negative number. There's no upper limit in value, although visually OHOS uses maximum achievable value. In order for this function to work properly, it has to be called before the window is shown.

Read more: [https://developer.huawei.com/consumer/en/doc/harmonyos-references/js-apis-window here].

<span id="setWindowCornerRadius-1"></span>
=== <span id="setWindowCornerRadius-1"></span><span class="type">void</span> QtOhosExtras::<span class="name">setWindowCornerRadius</span>(<span class="type">[[../qtwidgets/qwidget.html|QWidget]]</span> *''widget'', <span class="type">double</span> ''radius'') ===

Sets corner ''radius'' for a ''widget''. Given ''widget'' has to be formed as a new window, it means it cannot be embedded in a parent widget. It can be achieved for example: - by setting [[../qtcore/qt.html#WindowType-enum|Qt::WindowFlags]], like: [[../qtcore/qt.html#WindowType-enum|Qt::Window]], [[../qtcore/qt.html#WindowType-enum|Qt::Popup]], [[../qtcore/qt.html#WindowType-enum|Qt::Dialog]] etc. - explicitly using QtOhosExtras::setShowWindowAsFloatWindowHint() function. More on widgets as windows in: [https://doc.qt.io/archives/qt-5.15/qwidget.html Qt official docs]. The ''radius'' must not be a negative number. There's no upper limit in value, although visually OHOS uses maximum achievable value. In order for this function to work properly, it has to be called before the widget is shown.

Read more: [https://developer.huawei.com/consumer/en/doc/harmonyos-references/js-apis-window here].

<span id="setWindowKeepScreenOn"></span>
=== <span id="setWindowKeepScreenOn"></span><span class="type">void</span> QtOhosExtras::<span class="name">setWindowKeepScreenOn</span>(<span class="type">[[../qtgui/qwindow.html|QWindow]]</span> *''window'', <span class="type">bool</span> ''keepScreenOn'') ===

Sets or unsets a given ''window'' to keep the screen on according to ''keepScreenOn'' flag.

Read more: [https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-window-V5#setwindowkeepscreenon here].

<span id="setWindowKeepScreenOn-1"></span>
=== <span id="setWindowKeepScreenOn-1"></span><span class="type">void</span> QtOhosExtras::<span class="name">setWindowKeepScreenOn</span>(<span class="type">[[../qtwidgets/qwidget.html|QWidget]]</span> *''widget'', <span class="type">bool</span> ''keepScreenOn'') ===

Sets or unsets a given ''widget'' to keep the screen on according to ''keepScreenOn'' flag.

Read more: [https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-window-V5#setwindowkeepscreenon here].

<span id="setWindowPrivacyMode"></span>
=== <span id="setWindowPrivacyMode"></span><span class="type">void</span> QtOhosExtras::<span class="name">setWindowPrivacyMode</span>(<span class="type">[[../qtgui/qwindow.html|QWindow]]</span> *''window'', <span class="type">bool</span> ''privacyModeEnabled'') ===

Change window privacy mode according to a given ''window'' and ''privacyModeEnabled''. Read more about window privacy mode [https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-window-V5#setwindowprivacymode9 here]

<span id="startAbility"></span>
=== startAbility ===

<syntaxhighlight lang="cpp">
QSharedPointer<QtOhosExtras::QOhosOperationStatus> QtOhosExtras::startAbility(const QtOhosExtras::QOhosWant &''want'')
</syntaxhighlight>

Starts an Ability for a given ''want''. See [https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-inner-application-uiabilitycontext-V5#uiabilitycontextstartability Start Ability].

'''Warning:''' Currently, operation status result is hardcoded as &quot;successful&quot; (even if ability were not started).

<span id="startAbility-1"></span>
=== startAbility ===

<syntaxhighlight lang="cpp">
QSharedPointer<QtOhosExtras::QOhosOperationStatus> QtOhosExtras::startAbility(const QtOhosExtras::QOhosWant &''want'', const QtOhosExtras::QOhosStartOptions &''options'')
</syntaxhighlight>

Starts an Ability for a given ''want'' and ''options''. See [https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-inner-application-uiabilitycontext-V5#uiabilitycontextstartability-1 Start Ability].

'''Warning:''' Currently, operation status result is hardcoded as &quot;successful&quot; (even if ability were not started).

<span id="startAbilityByType"></span>
=== startAbilityByType ===

<syntaxhighlight lang="cpp">
QSharedPointer<QtOhosExtras::QOhosOperationStatus> QtOhosExtras::startAbilityByType(const QString &''appType'', const QJsonObject &''wantParameters'')
</syntaxhighlight>

Starts an Ability for a given ''appType'' and ''wantParameters''. See [https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-inner-application-uiabilitycontext-V5#uiabilitycontextstartabilitybytype11-1 Start Ability].

Returns true on success

<span id="startAppProcess"></span>
=== <span id="startAppProcess"></span><span class="type">void</span> QtOhosExtras::<span class="name">startAppProcess</span>(const <span class="type">[[../qtcore/qstring.html|QString]]</span> &amp;''processId'', const <span class="type">[[qtohosextras_QOhosWant_Class|QtOhosExtras::QOhosWant]]</span> &amp;''requestWant'') ===

Starts application process for a given ''processId'' and ''requestWant''.

<span id="startAppProcess-1"></span>
=== <span id="startAppProcess-1"></span><span class="type">void</span> QtOhosExtras::<span class="name">startAppProcess</span>(const <span class="type">[[../qtcore/qstring.html|QString]]</span> &amp;''processId'', const <span class="type">[[qtohosextras_QOhosWant_Class|QtOhosExtras::QOhosWant]]</span> &amp;''requestWant'', const <span class="type">[[qtohosextras_QOhosStartOptions_Class|QtOhosExtras::QOhosStartOptions]]</span> &amp;''options'') ===

Starts application process for a given ''processId'', ''requestWant'' and ''options''.

<span id="startNewAbilityInstance"></span>
=== <span id="startNewAbilityInstance"></span><span class="type">void</span> QtOhosExtras::<span class="name">startNewAbilityInstance</span>(<span class="type">[[../qtwidgets/qwidget.html|QWidget]]</span> *''instanceWidget'') ===

Starts another instance of the UIAbility used by the Qt app with specified widget inside

The caller should pass newly created [[../qtwidgets/qwidget.html|QWidget]] ''instanceWidget'', without any setting any parent, calling show() or winId() on it.

<span id="tryGetNativeWindowId"></span>
=== tryGetNativeWindowId ===

<syntaxhighlight lang="cpp">
QSharedPointer<double> QtOhosExtras::tryGetNativeWindowId(QWindow *''window'')
</syntaxhighlight>

Function tries to obtain native window ID (ID associated with system window object) of given ''window''. The failure of the operation is indicated by returned value equal to <code>nullptr</code>.

'''Note:''' This function must be called only after the ''window'' has been shown.

'''Warning:''' Returned native window ID isn't guaranteed to be valid throughout the lifetime of application. Application stability and performance may be poor after using this function, use it at your own risk!

Read more on native window ID (WindowProperties.id): [https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-window-V5#windowproperties here]

<span id="tryGetOnContinueData"></span>
=== tryGetOnContinueData ===

<syntaxhighlight lang="cpp">
QSharedPointer<QByteArray> QtOhosExtras::tryGetOnContinueData(const QtOhosExtras::QOhosWant &''want'')
</syntaxhighlight>

<span id="tryGetScreenDisplayId"></span>
=== tryGetScreenDisplayId ===

<syntaxhighlight lang="cpp">
QSharedPointer<double> QtOhosExtras::tryGetScreenDisplayId(QScreen *''screen'')
</syntaxhighlight>

Function tries to obtain native display ID of given ''screen''. The failure of the operation is indicated by returning <code>nullptr</code> .

Read more on display ID (Display.id): [https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-display-V5#display here]

<span id="tryMapQOhosPermissionFromName"></span>
=== <span id="tryMapQOhosPermissionFromName"></span><span class="type">int</span> QtOhosExtras::<span class="name">tryMapQOhosPermissionFromName</span>(''const QString &amp;'') ===

<span id="tryMapQOhosPermissionToName"></span>
=== <span id="tryMapQOhosPermissionToName"></span><span class="type">int</span> QtOhosExtras::<span class="name">tryMapQOhosPermissionToName</span>(''int'') ===

<span id="operator-7c"></span>
=== Function ===

<syntaxhighlight lang="cpp">
QFlags<QOhosWantFlags::enum_type> QtOhosExtras::operator|(QOhosWantFlags::enum_type ''f1'', QOhosWantFlags::enum_type ''f2'')
</syntaxhighlight>

<span id="operator-7c-1"></span>
=== Function ===

<syntaxhighlight lang="cpp">
QFlags<QOhosWantFlags::enum_type> QtOhosExtras::operator|(QOhosWantFlags::enum_type ''f1'', QFlags<QOhosWantFlags::enum_type> ''f2'')
</syntaxhighlight>

<span id="operator-7c-2"></span>
=== <span id="operator-7c-2"></span><span class="type">[[../qtcore/qincompatibleflag.html|QIncompatibleFlag]]</span> QtOhosExtras::<span class="name">operator|</span>(<span class="type">QOhosWantFlags::enum_type</span> ''f1'', <span class="type">int</span> ''f2'') ===


</div>