Plasma::RunnerContext

Plasma::RunnerContext Class Reference

#include <KRunner/RunnerContext>

Inheritance diagram for Plasma::RunnerContext:

Public Types

enum  Type {
  None = 0, UnknownType = 1, Directory = 2, File = 4,
  NetworkLocation = 8, Executable = 16, ShellCommand = 32, Help = 64,
  FileSystem = Directory | File | Executable | ShellCommand
}
 
typedef QFlags< Type > Types
 

Signals

void matchesChanged ()
 

Public Member Functions

 RunnerContext (QObject *parent=nullptr)
 
 RunnerContext (RunnerContext &other, QObject *parent=nullptr)
 
bool addMatch (const QueryMatch &match)
 
bool addMatches (const QList< QueryMatch > &matches)
 
QStringList enabledCategories () const
 
bool isValid () const
 
QueryMatch match (const QString &id) const
 
QList< QueryMatchmatches () const
 
QString mimeType () const
 
RunnerContextoperator= (const RunnerContext &other)
 
QString query () const
 
bool removeMatch (const QString matchId)
 
bool removeMatches (const QStringList matchIdList)
 
bool removeMatches (AbstractRunner *runner)
 
void reset ()
 
void restore (const KConfigGroup &config)
 
void run (const QueryMatch &match)
 
void save (KConfigGroup &config)
 
void setEnabledCategories (const QStringList &categories)
 
void setQuery (const QString &term)
 
void setSingleRunnerQueryMode (bool enabled)
 
bool singleRunnerQueryMode () const
 
Type type () const
 
- Public Member Functions inherited from QObject
 QObject (QObject *parent)
 
bool blockSignals (bool block)
 
const QObjectListchildren () const const
 
QMetaObject::Connection connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const const
 
void deleteLater ()
 
void destroyed (QObject *obj)
 
bool disconnect (const char *signal, const QObject *receiver, const char *method) const const
 
bool disconnect (const QObject *receiver, const char *method) const const
 
void dumpObjectInfo ()
 
void dumpObjectInfo () const const
 
void dumpObjectTree ()
 
void dumpObjectTree () const const
 
QList< QByteArraydynamicPropertyNames () const const
 
virtual bool event (QEvent *e)
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 
findChild (const QString &name, Qt::FindChildOptions options) const const
 
QList< T > findChildren (const QString &name, Qt::FindChildOptions options) const const
 
QList< T > findChildren (const QRegExp &regExp, Qt::FindChildOptions options) const const
 
QList< T > findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const
 
bool inherits (const char *className) const const
 
void installEventFilter (QObject *filterObj)
 
bool isWidgetType () const const
 
bool isWindowType () const const
 
void killTimer (int id)
 
virtual const QMetaObjectmetaObject () const const
 
void moveToThread (QThread *targetThread)
 
QString objectName () const const
 
void objectNameChanged (const QString &objectName)
 
QObjectparent () const const
 
QVariant property (const char *name) const const
 
 Q_CLASSINFO (Name, Value)
 
 Q_DISABLE_COPY (Class)
 
 Q_DISABLE_COPY_MOVE (Class)
 
 Q_DISABLE_MOVE (Class)
 
 Q_EMIT Q_EMIT
 
 Q_ENUM (...)
 
 Q_ENUM_NS (...)
 
 Q_ENUMS (...)
 
 Q_FLAG (...)
 
 Q_FLAG_NS (...)
 
 Q_FLAGS (...)
 
 Q_GADGET Q_GADGET
 
 Q_INTERFACES (...)
 
 Q_INVOKABLE Q_INVOKABLE
 
 Q_NAMESPACE Q_NAMESPACE
 
 Q_NAMESPACE_EXPORT (EXPORT_MACRO)
 
 Q_OBJECT Q_OBJECT
 
 Q_PROPERTY (...)
 
 Q_REVISION Q_REVISION
 
 Q_SET_OBJECT_NAME (Object)
 
 Q_SIGNAL Q_SIGNAL
 
 Q_SIGNALS Q_SIGNALS
 
 Q_SLOT Q_SLOT
 
 Q_SLOTS Q_SLOTS
 
qFindChild (const QObject *obj, const QString &name)
 
QList< T > qFindChildren (const QObject *obj, const QRegExp &regExp)
 
QList< T > qFindChildren (const QObject *obj, const QString &name)
 
qobject_cast (QObject *object)
 
qobject_cast (const QObject *object)
 
 QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT
 
void removeEventFilter (QObject *obj)
 
void setObjectName (const QString &name)
 
void setParent (QObject *parent)
 
bool setProperty (const char *name, const QVariant &value)
 
bool signalsBlocked () const const
 
int startTimer (int interval, Qt::TimerType timerType)
 
int startTimer (std::chrono::milliseconds time, Qt::TimerType timerType)
 
QThreadthread () const const
 

Additional Inherited Members

- Properties inherited from QObject
 objectName
 
- Static Public Member Functions inherited from QObject
QMetaObject::Connection connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
 
QMetaObject::Connection connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
 
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method, Qt::ConnectionType type)
 
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)
 
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type)
 
bool disconnect (const QMetaObject::Connection &connection)
 
bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
 
bool disconnect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method)
 
bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
 
QString tr (const char *sourceText, const char *disambiguation, int n)
 
QString trUtf8 (const char *sourceText, const char *disambiguation, int n)
 
- Public Attributes inherited from QObject
typedef QObjectList
 
- Protected Member Functions inherited from QObject
virtual void childEvent (QChildEvent *event)
 
virtual void connectNotify (const QMetaMethod &signal)
 
virtual void customEvent (QEvent *event)
 
virtual void disconnectNotify (const QMetaMethod &signal)
 
bool isSignalConnected (const QMetaMethod &signal) const const
 
int receivers (const char *signal) const const
 
QObjectsender () const const
 
int senderSignalIndex () const const
 
virtual void timerEvent (QTimerEvent *event)
 

Detailed Description

The RunnerContext class provides information related to a search, including the search term, metadata on the search term and collected matches.

Definition at line 45 of file runnercontext.h.

Constructor & Destructor Documentation

Plasma::RunnerContext::RunnerContext ( RunnerContext other,
QObject parent = nullptr 
)

Copy constructor.

Definition at line 285 of file runnercontext.cpp.

Member Function Documentation

bool Plasma::RunnerContext::addMatch ( const QueryMatch match)

Appends a match to the existing list of matches.

If you are going to be adding multiple matches, use

See also
addMatches instead.
Parameters
matchthe match to add
Returns
true if the match was added, false otherwise.

Definition at line 428 of file runnercontext.cpp.

bool Plasma::RunnerContext::addMatches ( const QList< QueryMatch > &  matches)

Appends lists of matches to the list of matches.

Parameters
matchesthe matches to add
Returns
true if matches were added, false if matches were e.g. outdated

Definition at line 395 of file runnercontext.cpp.

QStringList Plasma::RunnerContext::enabledCategories ( ) const

A list of categories of which results should be returned.

This list is typically populated from the AbstractRunner::categories function.

Definition at line 371 of file runnercontext.cpp.

bool Plasma::RunnerContext::isValid ( ) const
Returns
true if this context is no longer valid and therefore matching using it should abort. Most useful as an optimization technique inside of AbstractRunner subclasses in the match method, e.g.:

while (.. a possibly large iteration) { if (!context.isValid()) { return; }

... some processing ... }

While not required to be used within runners, it provides a nice way to avoid unnecessary processing in runners that may run for an extended period (as measured in 10s of ms) and therefore improve the user experience.

Since
4.2.3

Definition at line 386 of file runnercontext.cpp.

QueryMatch Plasma::RunnerContext::match ( const QString id) const

Retrieves a match by id.

Parameters
idthe id of the match to return
Returns
the match associated with this id, or an invalid QueryMatch object if the id does not exist

Definition at line 548 of file runnercontext.cpp.

QList< QueryMatch > Plasma::RunnerContext::matches ( ) const

Retrieves all available matches for the current search term.

Returns
a list of matches

Definition at line 540 of file runnercontext.cpp.

QString Plasma::RunnerContext::mimeType ( ) const

The mimetype that the search term refers to, if discoverable.

Returns
QString() if the mimetype can not be determined, otherwise the mimetype of the object being referred to by the search string.

Definition at line 381 of file runnercontext.cpp.

RunnerContext & Plasma::RunnerContext::operator= ( const RunnerContext other)

Assignment operator.

Since
4.4

Definition at line 297 of file runnercontext.cpp.

QString Plasma::RunnerContext::query ( ) const
Returns
the current search query term.

Definition at line 358 of file runnercontext.cpp.

bool Plasma::RunnerContext::removeMatch ( const QString  matchId)

Removes a match from the existing list of matches.

If you are going to be removing multiple matches, use removeMatches instead.

Parameters
matchIdthe id of match to remove
Returns
true if the match was removed, false otherwise.
Since
4.4

Definition at line 489 of file runnercontext.cpp.

bool Plasma::RunnerContext::removeMatches ( const QStringList  matchIdList)

Removes lists of matches from the existing list of matches.

This method is thread safe and causes the matchesChanged() signal to be emitted.

Parameters
matchIdListthe list of matches id to remove
Returns
true if at least one match was removed, false otherwise.
Since
4.4

Definition at line 452 of file runnercontext.cpp.

bool Plasma::RunnerContext::removeMatches ( Plasma::AbstractRunner runner)

Removes lists of matches from a given AbstractRunner.

This method is thread safe and causes the matchesChanged() signal to be emitted.

Parameters
runnerthe AbstractRunner from which to remove matches
Returns
true if at least one match was removed, false otherwise.
Since
4.10

Definition at line 509 of file runnercontext.cpp.

void Plasma::RunnerContext::reset ( )

Resets the search term for this object.

This removes all current matches in the process and turns off single runner query mode.

Definition at line 312 of file runnercontext.cpp.

void Plasma::RunnerContext::restore ( const KConfigGroup config)

Sets the launch counts for the associated match ids.

If a runner adds a match to this context, the context will check if the match id has been launched before and increase the matches relevance correspondingly. In this manner, any front end can implement adaptive search by sorting items according to relevance.

Parameters
configthe config group where launch data was stored

Definition at line 571 of file runnercontext.cpp.

void Plasma::RunnerContext::run ( const QueryMatch match)

Run a match using the information from this context.

The context will also keep track of the number of times the match was launched to sort future matches according to user habits

Parameters
matchthe match to run

Definition at line 601 of file runnercontext.cpp.

void Plasma::RunnerContext::save ( KConfigGroup config)
Parameters
configthe config group where launch data should be stored

Definition at line 587 of file runnercontext.cpp.

void Plasma::RunnerContext::setEnabledCategories ( const QStringList categories)

Sets the list of enabled categories.

Runners can use this list to optimize themselves by only returning results from the enabled categories

Definition at line 366 of file runnercontext.cpp.

void Plasma::RunnerContext::setQuery ( const QString term)

Sets the query term for this object and attempts to determine the type of the search.

Definition at line 346 of file runnercontext.cpp.

void Plasma::RunnerContext::setSingleRunnerQueryMode ( bool  enabled)

Sets single runner query mode.

Note that a call to reset() will turn off single runner query mode.

See also
reset()
Since
4.4

Definition at line 561 of file runnercontext.cpp.

bool Plasma::RunnerContext::singleRunnerQueryMode ( ) const
Returns
true if the current query is a single runner query
Since
4.4

Definition at line 566 of file runnercontext.cpp.

RunnerContext::Type Plasma::RunnerContext::type ( ) const

The type of item the search term might refer to.

See also
Type

Definition at line 376 of file runnercontext.cpp.


The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2020 The KDE developers.
Generated on Sun Jul 5 2020 22:39:42 by doxygen 1.8.11 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.