/usr/include/kactivities/info.h is in libkactivities-dev 4:4.8.2-0ubuntu2.
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 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 | /*
* Copyright (c) 2010 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_INFO_H_
#define ACTIVITIES_INFO_H_
#include <QObject>
#include <QWidget>
#include <QString>
#include <QStringList>
#include <kurl.h>
#include <kdemacros.h>
#include "kactivities_export.h"
namespace KActivities {
class InfoPrivate;
/**
* This class provides info about an activity. Most methods in it
* require a Nepomuk backend running.
*
* @see Consumer for info about activities
*
* @since 4.5
*/
class KACTIVITIES_EXPORT Info: public QObject
{
Q_OBJECT
Q_PROPERTY(KUrl uri READ uri)
Q_PROPERTY(KUrl resourceUri READ resourceUri)
Q_PROPERTY(QString id READ id)
Q_PROPERTY(QString name READ name)
public:
explicit Info(const QString & activityId, QObject *parent=0);
~Info();
/**
* @return true if the activity represented by this object exists and is valid
*/
bool isValid() const;
/**
* Specifies which parts of this class are functional
*/
enum Availability {
Nothing = 0, ///< No activity info provided (isValid is false)
BasicInfo = 1, ///< Basic info is provided
Everything = 2 ///< Everything is available
};
/**
* State of the activity
*/
enum State {
Invalid = 0,
Running = 2,
Starting = 3,
Stopped = 4,
Stopping = 5
};
/**
* @returns what info is provided by this instance of Info
*/
Availability availability() const;
/**
* @returns the URI of this activity. The same URI is used by
* activities KIO slave.
* @note Functional only when availability is Everything
*/
KUrl uri() const;
/**
* @returns the Nepomuk resource URI of this activity
* @note Functional only when availability is Everything
*/
KUrl resourceUri() const;
/**
* @returns the id of the activity
*/
QString id() const;
/**
* @returns the name of the activity
* @note Functional when availability is BasicInfo or Everything
*/
QString name() const;
/**
* @returns the icon of the activity. Icon can be a
* freedesktop.org name or a file path. Or empty if
* no icon is set.
* @note Functional only when availability is Everything
*/
QString icon() const;
/**
* @returns the state of the activity
*/
State state() const;
/**
* This function is provided for convenience.
* @returns the name of the specified activity
* @param id id of the activity
*/
static QString name(const QString & id);
Q_SIGNALS:
/**
* Emitted when the activity's name, icon or description is changed
*/
void infoChanged();
/**
* Emitted when the activity is added
*/
void added();
/**
* Emitted when the activity is removed
*/
void removed();
/**
* Emitted when the activity is started
*/
void started();
/**
* Emitted when the activity is stopped
*/
void stopped();
/**
* Emitted when the activity changes state
* @param state new state of the activity
*/
void stateChanged(KActivities::Info::State state);
private:
InfoPrivate * const d;
Q_PRIVATE_SLOT(d, void activityStateChanged(const QString &, int))
Q_PRIVATE_SLOT(d, void added(const QString &))
Q_PRIVATE_SLOT(d, void removed(const QString &))
Q_PRIVATE_SLOT(d, void started(const QString &))
Q_PRIVATE_SLOT(d, void stopped(const QString &))
Q_PRIVATE_SLOT(d, void infoChanged(const QString &))
friend class InfoPrivate;
};
} // namespace KActivities
#endif // ACTIVITIES_INFO_H_
|