KActivitiesStats 5.109.0
Public Member Functions | List of all members
KActivities::Stats::Query

The activities system tracks resources (documents, contacts, etc.) that the user has used. More...

#include <KActivities/Stats/Query>

Public Member Functions

 Query (const Query &source)
 
 Query (Query &&source)
 
 Query (Terms::Select selection=Terms::AllResources)
 
QStringList activities () const
 
void addActivities (const QStringList &activities)
 
void addAgents (const QStringList &agents)
 
void addTypes (const QStringList &types)
 
void addUrlFilters (const QStringList &urlFilters)
 
QStringList agents () const
 
void clearActivities ()
 
void clearAgents ()
 
void clearTypes ()
 
void clearUrlFilters ()
 
QDate dateEnd () const
 
QDate dateStart () const
 
int limit () const
 
int offset () const
 
bool operator!= (const Query &right) const
 
Queryoperator= (Query source)
 
bool operator== (const Query &right) const
 
Terms::Order ordering () const
 
void removeActivities (const QStringList &activities)
 
void removeAgents (const QStringList &agents)
 
void removeTypes (const QStringList &types)
 
void removeUrlFilters (const QStringList &urlFilters)
 
Terms::Select selection () const
 
void setActivities (const Terms::Activity &activities)
 
void setAgents (const Terms::Agent &agents)
 
void setDate (const Terms::Date &date)
 
void setDateEnd (QDate date)
 
void setDateStart (QDate date)
 
void setLimit (int limit)
 
void setOffset (int offset)
 
void setOrdering (Terms::Order ordering)
 
void setSelection (Terms::Select selection)
 
void setTypes (const Terms::Type &types)
 
void setUrlFilters (const Terms::Url &urlFilters)
 
QStringList types () const
 
QStringList urlFilters () const
 

Detailed Description

The activities system tracks resources (documents, contacts, etc.) that the user has used.

It also allows linking resources to specific activities (like bookmarks, favorites, etc.).

The Query class specifies which resources to return - the previously used ones, the linked ones, or to combine these two.

It allows filtering the results depending on the resource type, the agent (application that reported the usage event, see KActivities::ResourceInstance) and the activity the resource has been used in, or linked to. It also allows filtering on the URL of the resource.

While it can be explicitly instantiated, a preferred approach is to use the pipe syntax like this:

auto query = UsedResources
| RecentlyUsedFirst
| Agent::any()
| Type::any()
| Activity::current();

Member Function Documentation

◆ setActivities()

void KActivities::Stats::Query::setActivities ( const Terms::Activity activities)
Since
5.62

◆ setAgents()

void KActivities::Stats::Query::setAgents ( const Terms::Agent agents)
Since
5.62

◆ setDate()

void KActivities::Stats::Query::setDate ( const Terms::Date date)
Since
5.62

◆ setTypes()

void KActivities::Stats::Query::setTypes ( const Terms::Type types)
Since
5.62

◆ setUrlFilters()

void KActivities::Stats::Query::setUrlFilters ( const Terms::Url urlFilters)
Since
5.62