/usr/include/KF5/KActivities/kactivities/controller.h is in libkf5activities-dev 5.18.0-0ubuntu1.
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 | /*
* Copyright (c) 2010, 2011, 2012 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 Library General Public
* License version 2 as published by the Free Software Foundation.
*
* 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
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public License
* along with this library; see the file COPYING.LIB. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#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
|