4783f50ef2 | ||
---|---|---|
LICENSES | ||
autotests | ||
debian | ||
src | ||
tests | ||
.git-blame-ignore-revs | ||
.gitignore | ||
.gitlab-ci.yml | ||
.kde-ci.yml | ||
.vim-template:cpp | ||
.vim-template:h | ||
CMakeLists.txt | ||
KF5ActivitiesStatsConfig.cmake.in | ||
MAINTAINER | ||
README.developers | ||
README.md | ||
TODO | ||
logo.png | ||
metainfo.yaml | ||
vim-extrarc |
README.md
KActivitiesStats
Library to access the usage statistics data collected by the KDE activity manager.
Introduction
The KActivitiesStats library provides a querying mechanism for the data that the activity manager collects - which documents hae been opened by which applications, and what documents have been linked to which activity. The activity manager also keeps the score for each document which gets higher when a particular document has been often accessed or kept open for longer periods of time. This score is also available through the querying mechanism.
Usage
The library provides the following important classes:
KActivities::Stats::ResultSet
is a low level class that provides a forward iterator to the list of results that match the specified queryKActivities::Stats::ResultWatcher
provides signals when a new resource that matches a query arrives, or when an existing one is gone (usage statistics cleared or some for other reason)KActivities::Stats::ResultModel
provides a Qt data model that shows the resources that match the specified query. This model should be subclassed to teach it to handle the different resource types that you want to show as the results.
Queries are defined by the KActivities::Stats::Query
class using a simple range-like syntax.