Jump to content

Qt for HarmonyOS/qtohosextras doc/QOhosAppContext Class

From Qt Wiki

< Qt for HarmonyOS / qtohosextras doc

QOhosAppContext Class

The QOhosAppContext class contains API to manage native application context. More...

Header: #include <QOhosAppContext>
qmake: QT += ohosextras
Since: Qt 5.12.12
Inherits: QObject

Public Types

enum ColorThemeMode { LightTheme, DarkTheme, FollowSystemSetting }

Public Functions

virtual bool darkThemeActive() const = 0
virtual void enableContextMenuEventOnLongPress() = 0
virtual double fontSizeScale() const = 0
int getBundleInfo() const
virtual bool isPermissionGranted(int permission) const = 0
virtual bool isPermissionGranted(const QString &permissionName) const = 0
virtual void requestPermissionFromUserIfNeeded(int permission) = 0
virtual void requestPermissionOnSettingIfNeeded(int permission) = 0
virtual void restartApp() = 0
virtual void restartApp(const int &want) = 0
virtual void setColorThemeMode(QtOhosExtras::QOhosAppContext::ColorThemeMode mode) = 0

Signals

void darkThemeActiveChanged(bool darkThemeActive)
void fontSizeScaleChanged(double fontSizeScale)
void permissionRequestOnSettingResponseReceived(int permission, bool permissionGranted)
void permissionRequestResponseReceived(int permission, bool permissionGranted)
void permissionRequestResponseWithResultReceived(int permission, int result)

Static Public Members

int getAppLaunchWant()
int getAppLaunchWantInfo()
QtOhosExtras::QOhosAppContext * instance()
bool isNoUiChildMode()
void startNoUiChildProcess(QString libraryName, QStringList args)
const QMetaObject staticMetaObject

Protected Functions

QOhosAppContext()
QOhosAppContext(const QtOhosExtras::QOhosAppContext &)
virtual ~QOhosAppContext() override
QtOhosExtras::QOhosAppContext & operator=(const QtOhosExtras::QOhosAppContext &)

Detailed Description

The QOhosAppContext class contains API to manage native application context.

Member Type Documentation

enum QOhosAppContext::ColorThemeMode

Defines the color theme mode for the application.

Constant Value Description
QtOhosExtras::QOhosAppContext::LightTheme 0 Uses the light theme colors (default).
QtOhosExtras::QOhosAppContext::DarkTheme 1 Uses the dark theme colors.
QtOhosExtras::QOhosAppContext::FollowSystemSetting 2 Automatically updates the theme based on the system setting.

Member Function Documentation

[protected] QOhosAppContext::QOhosAppContext()

Default constructs an instance of QOhosAppContext.

[virtual protected] QOhosAppContext::~QOhosAppContext()

Destroys the instance of QOhosAppContext.

[pure virtual] bool QOhosAppContext::darkThemeActive() const

Returns whether the dark color theme is active.

[pure virtual] void QOhosAppContext::enableContextMenuEventOnLongPress()

Enable context menu triggering on long press touch for the entire application lifetime.

[pure virtual] double QOhosAppContext::fontSizeScale() const

Returns font size scale ratio. The value ranges from 0 to 3.2.

int QOhosAppContext::getBundleInfo() const

Returns QOhosBundleInfo object for the current application.

[pure virtual] bool QOhosAppContext::isPermissionGranted(int permission) const

Returns true if a given permission is granted.

[pure virtual] void QOhosAppContext::restartApp()

Restarts the Application using the app launch want.

[pure virtual] void QOhosAppContext::setColorThemeMode(QtOhosExtras::QOhosAppContext::ColorThemeMode mode)

Sets the application's color theme to fixed value or enables automatic theme updates.

[static] void QOhosAppContext::startNoUiChildProcess(QString libraryName, QStringList args)

Starts "No UI" child process for a given libraryName and args.