KRunner::RunnerContext Class Reference

#include <KRunner/RunnerContext>

Public Member Functions
	RunnerContext (const RunnerContext &other)
	RunnerContext (RunnerManager *manager=nullptr)
bool	addMatch (const QueryMatch &match)
bool	addMatches (const QList< QueryMatch > &matches)
void	ignoreCurrentMatchForHistory () const
bool	isValid () const
QList< QueryMatch >	matches () const
RunnerContext &	operator= (const RunnerContext &other)
QString	query () const
void	requestQueryStringUpdate (const QString &text, int cursorPosition) const
void	setQuery (const QString &term)
bool	singleRunnerQueryMode () const

Detailed Description

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

Definition at line 31 of file runnercontext.h.

Constructor & Destructor Documentation

RunnerContext() [1/2]

KRunner::RunnerContext::RunnerContext ( RunnerManager * manager = nullptr )

explicit

Definition at line 97 of file runnercontext.cpp.

RunnerContext() [2/2]

KRunner::RunnerContext::RunnerContext

(

const RunnerContext &

other

)

Copy constructor.

Definition at line 103 of file runnercontext.cpp.

~RunnerContext()

KRunner::RunnerContext::~RunnerContext

(

)

Definition at line 109 of file runnercontext.cpp.

Member Function Documentation

addMatch()

bool KRunner::RunnerContext::addMatch

(

const QueryMatch &

match

)

Appends a match to the existing list of matches.

If you are going to be adding multiple matches, it is more performant to use

See also

addMatches instead.

Parameters

match

the match to add

Returns

true if the match was added, false otherwise.

Definition at line 213 of file runnercontext.cpp.

addMatches()

bool KRunner::RunnerContext::addMatches

(

const QList< QueryMatch > &

matches

)

Appends lists of matches to the list of matches.

Parameters

matches

the matches to add

Returns

true if matches were added, false if matches were e.g. outdated

Definition at line 190 of file runnercontext.cpp.

ignoreCurrentMatchForHistory()

void KRunner::RunnerContext::ignoreCurrentMatchForHistory

(

)

const

Set this to true in the AbstractRunner::run method to prevent the entry from being saved to the history.

Since

5.90

Definition at line 241 of file runnercontext.cpp.

isValid()

bool KRunner::RunnerContext::isValid

(

)

const

Returns

true if this context is no longer valid and therefore matching using it should abort. 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.

Definition at line 184 of file runnercontext.cpp.

matches()

QList< QueryMatch > KRunner::RunnerContext::matches

(

)

const

Retrieves all available matches for the current search term.

Returns

a list of matches

Definition at line 218 of file runnercontext.cpp.

operator=()

RunnerContext & KRunner::RunnerContext::operator=

(

const RunnerContext &

other

)

Assignment operator.

Definition at line 113 of file runnercontext.cpp.

query()

QString KRunner::RunnerContext::query

(

)

const

Returns

the current search query term.

Definition at line 176 of file runnercontext.cpp.

requestQueryStringUpdate()

void KRunner::RunnerContext::requestQueryStringUpdate	(	const QString &	text,
		int	cursorPosition ) const

Request that KRunner updates the query string and stasy open, even after running a match.

This method is const so it can be called in a const context.

Parameters

text	Text that will be displayed in the search field
cursorPosition	Position of the cursor, if this is different than the length of the text, the characters between the position and text will be selected

Since

5.90

Definition at line 225 of file runnercontext.cpp.

setQuery()

void KRunner::RunnerContext::setQuery

(

const QString &

term

)

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

Definition at line 162 of file runnercontext.cpp.

singleRunnerQueryMode()

bool KRunner::RunnerContext::singleRunnerQueryMode

(

)

const

Returns

true if the current query is a single runner query

Definition at line 236 of file runnercontext.cpp.

---

The documentation for this class was generated from the following files:

• runnercontext.h
• runnercontext.cpp