Qt for HarmonyOS/qtohosextras doc/QOhosStartOptions Class

QOhosStartOptions Class

class QtOhosExtras::QOhosStartOptions

The QOhosStartOptions class is to provide new options for new started ability or process. More...

Header:	#include <QOhosStartOptions>
qmake:	QT += ohosextras
Since:	Qt 5.12.12

This class was introduced in Qt 5.12.12.

• List of all members, including inherited members
• Obsolete members

Public Types

enum class	ProcessMode { NEW_PROCESS_ATTACH_TO_PARENT, NEW_PROCESS_ATTACH_TO_STATUS_BAR_ITEM }
enum class	StartupVisibility { STARTUP_HIDE, STARTUP_SHOW }
enum class	SupportWindowMode { FULL_SCREEN, SPLIT, FLOATING }
enum class	WindowMode { WINDOW_MODE_SPLIT_PRIMARY, WINDOW_MODE_SPLIT_SECONDARY, WINDOW_MODE_FULLSCREEN }

Public Functions

virtual void	setDisplayId(int displayId) = 0
virtual void	setHideStartWindow(bool hideStartWindow) = 0
virtual void	setMaxWindowHeight(int maxWindowHeight) = 0
virtual void	setMaxWindowWidth(int maxWindowWidth) = 0
virtual void	setMinWindowHeight(int minWindowHeight) = 0
virtual void	setMinWindowWidth(int minWindowWidth) = 0
virtual void	setProcessMode(ProcessMode processMode) = 0
virtual void	setStartWindowBackgroundColor(const QColor &startWindowBackgroundColor) = 0
virtual void	setStartWindowIcon(const QImage &startWindowIcon) = 0
virtual void	setStartupVisibility(StartupVisibility startupVisiblity) = 0
virtual void	setSupportWindowModes(const QList<SupportWindowMode> &supportWindowModes) = 0
virtual void	setWindowCreateParams(const QOhosWindowCreateParams &windowCreateParams) = 0
virtual void	setWindowHeight(int windowHeight) = 0
virtual void	setWindowLeft(int windowLeft) = 0
virtual void	setWindowMode(WindowMode windowMode) = 0
virtual void	setWindowTop(int windowTop) = 0
virtual void	setWindowWidth(int windowWidth) = 0
virtual void	setWithAnimation(bool withAnimation) = 0

Detailed Description

See also createStartOptions(), startAbility(), and startAppProcess().

Member Type Documentation

enum class QOhosStartOptions::ProcessMode

Enumerates the process modes. See Process Mode.

Constant	Value	Description
QtOhosExtras::QOhosStartOptions::ProcessMode::NEW_PROCESS_ATTACH_TO_PARENT	0	A new process is created, the ability is started on the process, and the process exits along with the parent process.
QtOhosExtras::QOhosStartOptions::ProcessMode::NEW_PROCESS_ATTACH_TO_STATUS_BAR_ITEM	1	A new process is created, the ability is started on the process, and the process is bound to the status bar icon.

This enum was introduced or modified in Qt 5.12.12.

enum class QOhosStartOptions::StartupVisibility

Enumerates the visibility statuses of an ability after it is started. See Startup Visibility.

Constant	Value	Description
QtOhosExtras::QOhosStartOptions::StartupVisibility::STARTUP_HIDE	0	The target ability is hidden after it is started in the new process.
QtOhosExtras::QOhosStartOptions::StartupVisibility::STARTUP_SHOW	1	The target ability is displayed normally after it is started in the new process.

This enum was introduced or modified in Qt 5.12.12.

enum class QOhosStartOptions::SupportWindowMode

Enumerates the supported window modes when the ability is started. See Support Window Mode.

Constant	Value	Description
QtOhosExtras::QOhosStartOptions::SupportWindowMode::FULL_SCREEN	0	Indicates support for full screen mode.
QtOhosExtras::QOhosStartOptions::SupportWindowMode::SPLIT	1	Indicates support for split mode.
QtOhosExtras::QOhosStartOptions::SupportWindowMode::FLOATING	2	Indicates support for floating mode.

This enum was introduced or modified in Qt 5.12.12.

enum class QOhosStartOptions::WindowMode

Enumerates the window mode when the ability is started. See Window Mode.

Constant	Value	Description
QtOhosExtras::QOhosStartOptions::WindowMode::WINDOW_MODE_SPLIT_PRIMARY	0	Primary screen (left screen in the case of horizontal orientation) in split-screen mode.
QtOhosExtras::QOhosStartOptions::WindowMode::WINDOW_MODE_SPLIT_SECONDARY	1	Secondary screen (right screen in the case of horizontal orientation) in split-screen mode.
QtOhosExtras::QOhosStartOptions::WindowMode::WINDOW_MODE_FULLSCREEN	2	Full screen mode.

This enum was introduced or modified in Qt 5.12.12.

Member Function Documentation

[pure virtual] void QOhosStartOptions::setDisplayId(int displayId)

Sets displayId. The default value is 0, indicating the current display. See Display Id.

[pure virtual] void QOhosStartOptions::setHideStartWindow(bool hideStartWindow)

Controls whether to hide the start window (hideStartWindow) when launching the current application's UIAbility.

See Hide Start Window.

[pure virtual] void QOhosStartOptions::setMaxWindowHeight(int maxWindowHeight)

Sets maxWindowHeight as the maximum height, in px.

See Maximum Window Height.

[pure virtual] void QOhosStartOptions::setMaxWindowWidth(int maxWindowWidth)

Sets maxWindowWidth as the maximum width, in px.

See Maximum Window Width.

[pure virtual] void QOhosStartOptions::setMinWindowHeight(int minWindowHeight)

Sets minWindowHeight as the minimum height, in px.

See Minimum Window Height.

[pure virtual] void QOhosStartOptions::setMinWindowWidth(int minWindowWidth)

Sets minWindowWidth as the minimum width, in px.

See Minimum Window Width.

[pure virtual] void QOhosStartOptions::setProcessMode(ProcessMode processMode)

Sets processMode. See Process Mode.

[pure virtual] void QOhosStartOptions::setStartWindowBackgroundColor(const QColor &startWindowBackgroundColor)

Sets startWindowBackgroundColor for the start window.

See Start Window Background Color.

[pure virtual] void QOhosStartOptions::setStartWindowIcon(const QImage &startWindowIcon)

Sets startWindowIcon for the start window.

See Start Window Icon.

[pure virtual] void QOhosStartOptions::setStartupVisibility(StartupVisibility startupVisiblity)

Sets startupVisiblity of the ability after it is started. See Startup Visiblity.

[pure virtual] void QOhosStartOptions::setSupportWindowModes(const QList<SupportWindowMode> &supportWindowModes)

Sets supportWindowModes when the ability is started. See Support Window Modes.

[pure virtual] void QOhosStartOptions::setWindowCreateParams(const QOhosWindowCreateParams &windowCreateParams)

Sets windowCreateParams used when creating the window.

See Window Create Params.

[pure virtual] void QOhosStartOptions::setWindowHeight(int windowHeight)

Sets windowHeight height of of the window. See Window Height.

[pure virtual] void QOhosStartOptions::setWindowLeft(int windowLeft)

Sets windowLeft left position of the window. See Window Left.

[pure virtual] void QOhosStartOptions::setWindowMode(WindowMode windowMode)

Sets windowMode when the ability is started. See Window Mode.

[pure virtual] void QOhosStartOptions::setWindowTop(int windowTop)

Sets windowTop top position of the window. See Window Top.

[pure virtual] void QOhosStartOptions::setWindowWidth(int windowWidth)

Sets windowWidth width of of the window. See Window Width.

[pure virtual] void QOhosStartOptions::setWithAnimation(bool withAnimation)

Sets withAnimation whether the ability has the animation effect. See With Animation.