Application QML Type
|Import Statement:||import QtApplicationManager 1.0|
- alias : bool
- applicationProperties : object
- backgroundMode : enumeration
- builtIn : bool
- capabilities : list<string>
- categories : list<string>
- codeDir : string
- documentUrl : string
- icon : url
- id : string
- importance : real
- lastExitCode : int
- lastExitStatus : enumeration
- nonAliased : Application
- preload : bool
- runtime : Runtime
- runtimeName : string
- runtimeParameters : object
- state : enumeration
- supportedMimeTypes : list<string>
- version : string
Most of the read-only properties map directly to values read from the application's
info.yaml file - these are documented in the Manifest Definition.
Note: There is an unfortunate naming conflict with the (undocumented)
Application object returned from Qt.application. If you want to use the enums defined in the application-manager's
Application class, you need to use an alias import:
import QtApplicationManager 1.0 as AppMan ... if (app.lastExitStatus == AppMan.Application.NormalExit) ...
All user-defined properties of this application as listed in the private and protected sections of the
applicationProperties field in the manifest file.
Specifies if and why the application needs to be kept running in the background - can be one of:
- Application.Auto - The application does not care.
- Application.Never - The application should not be kept running in the background.
- Application.ProvidesVoIP - The application provides VoIP services while in the background.
- Application.PlaysAudio - The application plays audio while in the background.
- Application.TracksLocation - The application tracks the current location while in the background.
By default, the background mode is
Auto. This is just a hint for the System-UI - the application-manager itself will not enforce this policy.
This property describes, if this application is part of the built-in set of applications of the current System-UI.
A list of special access rights for the application - these capabilities can later be queried and verified by the middleware via the application-manager.
A list of category names the application should be associated with. This is mainly for the automated app-store uploads as well as displaying the application within a fixed set of categories in the System-UI.
The absolute path to the application's installation directory. Please note this directory might not always be available for applications that were installed onto removable media.
See also Installation Locations.
This property always returns the default
documentUrl specified in the manifest file, even if a different URL was used to start the application.
[read-only] icon : url
The URL of the application's icon - can be used as the source property of an Image.
A value between
1.0 specifying the inverse probability of being terminated in out-of-memory situations (the default is
0.0 - unimportant).
This property holds the last exit-code of the application's process in multi-process mode. On successful application shutdown, this value should normally be
0, but can be whatever the application returns from its
This property returns the last exit-status of the application's process in multi-process mode.
- Application.NormalExit - The application exited normally.
- Application.CrashExit - The application crashed.
- Application.ForcedExit - The application was killed by the application-manager, since it ignored the quit request originating from a call to ApplicationManager::stopApplication.
[read-only] nonAliased : Application
If this Application object is an alias, then you can access the non-alias, base Application object via this property.
When set to true, the application-manager tries to start the application immediately after boot, but keeps it in the background.
[read-only] runtime : Runtime
Will return a valid Runtime object, if the application is currently starting, running or shutting down. May return a
null object, if the application was not yet started.
This property holds the name of the runtime, necessary to run the application's code.
This property holds a QVariantMap that is passed onto, and interpreted by the application's runtime.
This property holds the current installation state of the application. It can be one of:
- Application.Installed - The application is completely installed and ready to be used.
- Application.BeingInstalled - The application is currently in the process of being installed.
- Application.BeingUpdated - The application is currently in the process of being updated.
- Application.BeingRemoved - The application is currently in the process of being removed.
This signal is emitted when the application is started or when it's already running but has been requested to be brought to foreground or raised.
© 2018 Pelagicore AG. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.