Класс Autostart

(Sailfish::Mdm::Autostart)

Класс Autostart управляет автоматическим запуском приложений. Подробнее…

Заголовочный файл:

#include <mdm-autostart.h>

• Список всех членов класса, включая унаследованные

Публичные типы

• enum Result
• enum UID

Публичные методы

• Autostart(QObject *parent = Q_NULLPTR)
• virtual ~Autostart()
• Result disable(const QString &application, int uid = UID::Current)
• Result enable(const QString &application, int uid = UID::Current)
• QPair<Result, QStringList> list(int uid = UID::Current)

Подробное описание

Класс Autostart управляет автоматическим запуском приложений.

В частности, можно добавлять и удалять приложения из списка приложений, которые запускаются автоматически при запуске операционной системы.

Для использования данного класса в qmake-настройки проекта клиента следует добавить следующее:

 CONFIG += link_pkgconfig
 PKGCONFIG += sailfishmdm

и затем #include <mdm-autostart.h>.

Пример использования:

 #include <mdm-autostart.h>

 void example()
 {
     using namespace Sailfish::Mdm;

     Autostart autostart;

     // Включить автозапуск приложения для текущего пользователя
     autostart.enable("your-favourite-app");
     autostart.enable("your-favourite-app", Autostart::UID::Current);

     autostart.enable("your-favourite-app", 100000);
     autostart.enable("your-favourite-app", Autostart::UID::All);

     // Отключить автозапуск приложения для текущего пользователя
     autostart.disable("your-favourite-app");
     autostart.disable("your-favourite-app", Autostart::UID::Current);

     autostart.disable("your-favourite-app", 100000);
     autostart.disable("your-favourite-app", Autostart::UID::All);

     // Получить список текущих пользовательских приложений с автозапуском
     auto apps = autostart.list().second;
     auto apps = autostart.list(Autostart::UID::Current).second;

     auto apps = autostart.list(100000).second;
 }

Описание типов класса

enum Autostart::Result

Описывает результат действий enable(), disable() и list().

Константа	Значение	Описание
Sailfish::Mdm::Autostart::Success	0	Действие выполнено успешно
Sailfish::Mdm::Autostart::InternalError	1	При выполнении действия возникла внутренняя ошибка API

enum Autostart::UID

Константы для указания пользователя в действиях enable(), disable() и list().

Константа	Значение	Описание
Sailfish::Mdm::Autostart::All	-1	Выполнить действие для всех пользователей.
Sailfish::Mdm::Autostart::Current	-2	Выполнить действие для текущих пользователей.

Описание методов класса

Autostart::Autostart(QObject *parent = Q_NULLPTR)

Конструктор по умолчанию для класса Autostart.

[virtual] Autostart::~Autostart()

Деструктор для класса Autostart. Деструктор является виртуальным.

Result Autostart::disable(const QString &application, int uid = UID::Current)

Удаляет данное приложение, чтобы оно больше не запускалось автоматически при запуске указанного сеанса пользователя. application — название целевого приложения. uid — это идентификатор целевого пользователя (UID::All или UID::Current или любое положительное значение).

Result Autostart::enable(const QString &application, int uid = UID::Current)

Добавляет данное приложение для автоматического запуска при запуске указанного сеанса пользователя. application — название целевого приложения. uid — это идентификатор целевого пользователя (UID::All или UID::Current или любое положительное значение).

QPair<Result, QStringList> Autostart::list(int uid = UID::Current)

Запрашивает указанные автоматически запускаемые пользователем приложения. Возвращает результат действия и список автоматически запускаемых приложений указанного пользователя. uid — это целевой идентификатор пользователя (UID::Current или любое положительное значение, UID::All не поддерживается).