/usr/include/KF5/KActivities/kactivities/controller.h is in libkf5activities-dev 5.28.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 | /*
* Copyright (C) 2010 - 2016 by Ivan Cukic <ivan.cukic(at)kde.org>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) version 3, or any
* later version accepted by the membership of KDE e.V. (or its
* successor approved by the membership of KDE e.V.), which shall
* act as a proxy defined in Section 6 of version 3 of the license.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library.
* If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef ACTIVITIES_CONTROLLER_H
#define ACTIVITIES_CONTROLLER_H
#include <QObject>
#include <QString>
#include <QStringList>
#include <QFuture>
#include "consumer.h"
#include "kactivities_export.h"
namespace KActivities {
class ControllerPrivate;
/**
* This class provides methods for controlling and managing
* the activities.
*
* @note The QFuture objects returned by these methods are not thread-based,
* you can not call synchronous methods like waitForFinished, cancel, pause on
* them. You need either to register watchers to check when those have finished,
* or to check whether they are ready from time to time manually.
*
* @see Consumer for info about activities
*
* @since 5.0
*/
class KACTIVITIES_EXPORT Controller : public Consumer {
Q_OBJECT
Q_PROPERTY(QString currentActivity READ currentActivity WRITE setCurrentActivity)
public:
explicit Controller(QObject *parent = Q_NULLPTR);
~Controller();
/**
* Sets the name of the specified activity
* @param id id of the activity
* @param name name to be set
*/
QFuture<void> setActivityName(const QString &id, const QString &name);
/**
* Sets the description of the specified activity
* @param id id of the activity
* @param description description to be set
*/
QFuture<void> setActivityDescription(const QString &id,
const QString &description);
/**
* Sets the icon of the specified activity
* @param id id of the activity
* @param icon icon to be set - freedesktop.org name or file path
*/
QFuture<void> setActivityIcon(const QString &id, const QString &icon);
/**
* Sets the current activity
* @param id id of the activity to make current
* @returns true if successful
*/
QFuture<bool> setCurrentActivity(const QString &id);
/**
* Adds a new activity
* @param name name of the activity
* @returns id of the newly created activity
*/
QFuture<QString> addActivity(const QString &name);
/**
* Removes the specified activity
* @param id id of the activity to delete
*/
QFuture<void> removeActivity(const QString &id);
/**
* Stops the activity
* @param id id of the activity to stop
*/
QFuture<void> stopActivity(const QString &id);
/**
* Starts the activity
* @param id id of the activity to start
*/
QFuture<void> startActivity(const QString &id);
private:
// const QScopedPointer<ControllerPrivate> d;
};
} // namespace KActivities
#endif // ACTIVITIES_CONTROLLER_H
|