• Skip to content
  • Skip to link menu
KDE 4.2 API Reference
  • KDE API Reference
  • kdelibs
  • Sitemap
  • Contact Us
 

Plasma

Plasma::RunnerManager

Plasma::RunnerManager Class Reference

The RunnerManager class decides what installed runners are runnable, and their ratings. More...

#include <Plasma/RunnerManager>

Inheritance diagram for Plasma::RunnerManager:

Inheritance graph
[legend]

List of all members.


Public Slots

bool execQuery (const QString &term)
bool execQuery (const QString &term, const QString &runnerName)
void launchQuery (const QString &term)
void launchQuery (const QString &term, const QString &runnerName)
void reset ()

Signals

void matchesChanged (const QList< Plasma::QueryMatch > &matches)

Public Member Functions

QList< QAction * > actionsForMatch (const QueryMatch &match)
QList< QueryMatch > matches () const
QString query () const
void reloadConfiguration ()
void run (const QString &id)
void run (const QueryMatch &match)
AbstractRunner * runner (const QString &name) const
 RunnerManager (KConfigGroup &config, QObject *parent=0)
 RunnerManager (QObject *parent=0)
RunnerContext * searchContext () const
 ~RunnerManager ()

Detailed Description

The RunnerManager class decides what installed runners are runnable, and their ratings.

It is the main proxy to the runners.

Definition at line 47 of file runnermanager.h.


Constructor & Destructor Documentation

Plasma::RunnerManager::RunnerManager ( QObject *  parent = 0  )  [explicit]

Definition at line 312 of file runnermanager.cpp.

Plasma::RunnerManager::RunnerManager ( KConfigGroup &  config,
QObject *  parent = 0 
) [explicit]

Definition at line 321 of file runnermanager.cpp.

Plasma::RunnerManager::~RunnerManager (  ) 

Definition at line 332 of file runnermanager.cpp.


Member Function Documentation

QList< QAction * > Plasma::RunnerManager::actionsForMatch ( const QueryMatch &  match  ) 

Retrieves the list of actions, if any, for a match.

Definition at line 392 of file runnermanager.cpp.

bool Plasma::RunnerManager::execQuery ( const QString &  term  )  [slot]

Convenience version of above.

Definition at line 450 of file runnermanager.cpp.

bool Plasma::RunnerManager::execQuery ( const QString &  term,
const QString &  runnerName 
) [slot]

Execute a query, this method will only return when the query is executed This means that the method may be dangerous as it wait a variable amount of time for the runner to finish.

The runner parameter is mandatory, to avoid launching unwanted runners.

  • term the term we want to find matches for
  • runner the runner we will use, it is mandatory
    Returns:
    0 if nothing was launched, 1 if launched.

Definition at line 455 of file runnermanager.cpp.

void Plasma::RunnerManager::launchQuery ( const QString &  term  )  [slot]

Convenience version of above.

Definition at line 402 of file runnermanager.cpp.

void Plasma::RunnerManager::launchQuery ( const QString &  term,
const QString &  runnerName 
) [slot]

Launch a query, this will create threads and return inmediately.

When the information will be available can be known using the matchesChanged signal.

  • term the term we want to find matches for
  • runner optional, if only one specific runner is to be used

Definition at line 407 of file runnermanager.cpp.

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

Retrieves all available matches found so far for the previously launched query.

Returns:
List of matches

Definition at line 358 of file runnermanager.cpp.

void Plasma::RunnerManager::matchesChanged ( const QList< Plasma::QueryMatch > &  matches  )  [signal]

Emitted each time a new match is added to the list.

QString Plasma::RunnerManager::query (  )  const

Returns:
the current query term

Definition at line 493 of file runnermanager.cpp.

void Plasma::RunnerManager::reloadConfiguration (  ) 

Causes a reload of the current configuration.

Definition at line 337 of file runnermanager.cpp.

void Plasma::RunnerManager::reset (  )  [slot]

Reset the current data and stops the query.

Definition at line 498 of file runnermanager.cpp.

void Plasma::RunnerManager::run ( const QString &  id  ) 

Runs a given match.

  • id the id of the match to run

Definition at line 363 of file runnermanager.cpp.

void Plasma::RunnerManager::run ( const QueryMatch &  match  ) 

Runs a given match.

  • match the match to be executed

Definition at line 368 of file runnermanager.cpp.

AbstractRunner * Plasma::RunnerManager::runner ( const QString &  name  )  const

Finds and returns a loaded runner or NULL.

  • name the name of the runner
    Returns:
    Pointer to the runner

Definition at line 343 of file runnermanager.cpp.

RunnerContext * Plasma::RunnerManager::searchContext (  )  const

Retrieves the current context.

Returns:
pointer to the current context

Definition at line 352 of file runnermanager.cpp.


The documentation for this class was generated from the following files:
  • runnermanager.h
  • runnermanager.cpp

Plasma

Skip menu "Plasma"
  • Main Page
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

kdelibs

Skip menu "kdelibs"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • Kate
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • kio
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • Kross
  • KUtils
  • Nepomuk
  • Plasma
  • Solid
  • Sonnet
  • ThreadWeaver
Generated for kdelibs by doxygen 1.5.7
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal