C# Class Plasma.AbstractRunner

Inheritance: Qyoto.QObject
Mostra file Open project: 0xd34df00d/Qross

Public Methods

Method Description
AbstractRunner ( ) : System
AbstractRunner ( QObject parent ) : System
AbstractRunner ( QObject parent, List args ) : System
AbstractRunner ( QObject parent, string serviceId ) : System Constructs a Runner object. Since AbstractRunner has pure virtuals, this constructor can not be called directly. Rather a subclass must be created
DefaultSyntax ( ) : Plasma.RunnerSyntax
Description ( ) : string
HasRunOptions ( ) : bool If the runner has options that the user can interact with to modify what happens when run or one of the actions created in match is called, the runner should return true
Icon ( ) : Qyoto.QIcon
Id ( ) : string
IgnoredTypes ( ) : uint Returns the OR'ed value of all the Information types (as defined in RunnerContext.Type) this runner is not interested in.
Name ( ) : string
Package ( ) : Package Accessor for the associated Package object if any. Note that the returned pointer is only valid for the lifetime of the runner.
PerformMatch ( Plasma context ) : void Triggers a call to match. This will call match() internally. @arg context the search context used in executing this match.
SetIgnoredTypes ( uint types ) : void Sets the types this runner will ignore name="types" OR'ed listed of ignored types
Syntaxes ( ) : List
priority ( ) : Plasma.AbstractRunner.Priority The priority of the runner.
speed ( ) : Plasma.AbstractRunner.Speed The nominal speed of the runner.

Protected Methods

Method Description
AbstractRunner ( Type dummy ) : System
Action ( string id ) : Qyoto.QAction Returns the action associated with the id
Actions ( ) : string Returns all registered actions
AddAction ( string id, Qyoto.QIcon icon, string text ) : Qyoto.QAction Creates and then adds an action to the action registry. AbstractRunner assumes ownership of the created action. name="id" A unique identifier string name="icon" The icon to display name="text" The text to display
AddAction ( string id, Qyoto.QAction action ) : void Adds an action to the runner's action registry. The QAction must be created within the GUI thread; do not create it within the match method of AbstractRunner. name="id" A unique identifier string name="action" The QAction to be stored
AddSyntax ( Plasma syntax ) : void Adds a registered syntax that this runner understands. This is used to display to the user what this runner can understand and how it can be used. name="syntax" the syntax to register
ClearActions ( ) : void Clears the action registry. The action pool deletes the actions.
Config ( ) : Kimono.KConfigGroup Provides access to the runner's configuration object.
CreateProxy ( ) : void
DataEngine ( string name ) : DataEngine Loads the given DataEngine Tries to load the data engine given by name. Each engine is only loaded once, and that instance is re-used on all subsequent requests. If the data engine was not found, an invalid data engine is returned (see DataEngine.IsValid()). Note that you should not delete the returned engine. name="name" Name of the data engine to load
RemoveAction ( string id ) : void Removes the action from the action registry. AbstractRunner deletes the action once removed. name="id" The id of the action to be removed
SetDefaultSyntax ( Plasma syntax ) : void Set syntax as the default syntax for the runner; the default syntax will be substituted to the empty query in single runner mode. This is also used to display to the user what this runner can understand and how it can be used. The default syntax is automatically added to the list of registered syntaxes, there is no need to add it using addSyntax. Note that there can be only one default syntax; if called more than once, the last call will determine the default syntax. A default syntax (even trivial) is required to advertise single runner mode name="syntax" the syntax to register and to set as default
SetHasRunOptions ( bool hasRunOptions ) : void Sets whether or not the runner has options for matches
SetPriority ( Plasma newPriority ) : void Sets the priority of the runner. Lower priority runners are executed only after higher priority runners.
SetSpeed ( Plasma newSpeed ) : void Sets the nominal speed of the runner. Only slow runners need to call this within their constructor because the default speed is NormalSpeed. Runners that use DBUS should call this within their constructors.
SetSyntaxes ( List syns ) : void Sets the list of syntaxes; passing in an empty list effectively clears the syntaxes. name="the" syntaxes to register for this runner

Private Methods

Method Description
ActionsForMatch ( Plasma match ) : List
CreateRunOptions ( QWidget widget ) : void
Init ( ) : void
Match ( Plasma context ) : void
ReloadConfiguration ( ) : void
Run ( Plasma context, Plasma match ) : void

Method Details

AbstractRunner() public method

public AbstractRunner ( ) : System
return System

AbstractRunner() public method

public AbstractRunner ( QObject parent ) : System
parent Qyoto.QObject
return System

AbstractRunner() public method

public AbstractRunner ( QObject parent, List args ) : System
parent Qyoto.QObject
args List
return System

AbstractRunner() public method

Constructs a Runner object. Since AbstractRunner has pure virtuals, this constructor can not be called directly. Rather a subclass must be created
public AbstractRunner ( QObject parent, string serviceId ) : System
parent Qyoto.QObject
serviceId string
return System

AbstractRunner() protected method

protected AbstractRunner ( Type dummy ) : System
dummy System.Type
return System

Action() protected method

Returns the action associated with the id
protected Action ( string id ) : Qyoto.QAction
id string
return Qyoto.QAction

Actions() protected method

Returns all registered actions
protected Actions ( ) : string
return string

AddAction() protected method

Creates and then adds an action to the action registry. AbstractRunner assumes ownership of the created action. name="id" A unique identifier string name="icon" The icon to display name="text" The text to display
protected AddAction ( string id, Qyoto.QIcon icon, string text ) : Qyoto.QAction
id string
icon Qyoto.QIcon
text string
return Qyoto.QAction

AddAction() protected method

Adds an action to the runner's action registry. The QAction must be created within the GUI thread; do not create it within the match method of AbstractRunner. name="id" A unique identifier string name="action" The QAction to be stored
protected AddAction ( string id, Qyoto.QAction action ) : void
id string
action Qyoto.QAction
return void

AddSyntax() protected method

Adds a registered syntax that this runner understands. This is used to display to the user what this runner can understand and how it can be used. name="syntax" the syntax to register
protected AddSyntax ( Plasma syntax ) : void
syntax Plasma
return void

ClearActions() protected method

Clears the action registry. The action pool deletes the actions.
protected ClearActions ( ) : void
return void

Config() protected method

Provides access to the runner's configuration object.
protected Config ( ) : Kimono.KConfigGroup
return Kimono.KConfigGroup

CreateProxy() protected method

protected CreateProxy ( ) : void
return void

DataEngine() protected method

Loads the given DataEngine Tries to load the data engine given by name. Each engine is only loaded once, and that instance is re-used on all subsequent requests. If the data engine was not found, an invalid data engine is returned (see DataEngine.IsValid()). Note that you should not delete the returned engine. name="name" Name of the data engine to load
protected DataEngine ( string name ) : DataEngine
name string
return DataEngine

DefaultSyntax() public method

public DefaultSyntax ( ) : Plasma.RunnerSyntax
return Plasma.RunnerSyntax

Description() public method

public Description ( ) : string
return string

HasRunOptions() public method

If the runner has options that the user can interact with to modify what happens when run or one of the actions created in match is called, the runner should return true
public HasRunOptions ( ) : bool
return bool

Icon() public method

public Icon ( ) : Qyoto.QIcon
return Qyoto.QIcon

Id() public method

public Id ( ) : string
return string

IgnoredTypes() public method

Returns the OR'ed value of all the Information types (as defined in RunnerContext.Type) this runner is not interested in.
public IgnoredTypes ( ) : uint
return uint

Name() public method

public Name ( ) : string
return string

Package() public method

Accessor for the associated Package object if any. Note that the returned pointer is only valid for the lifetime of the runner.
public Package ( ) : Package
return Package

PerformMatch() public method

Triggers a call to match. This will call match() internally. @arg context the search context used in executing this match.
public PerformMatch ( Plasma context ) : void
context Plasma
return void

RemoveAction() protected method

Removes the action from the action registry. AbstractRunner deletes the action once removed. name="id" The id of the action to be removed
protected RemoveAction ( string id ) : void
id string
return void

SetDefaultSyntax() protected method

Set syntax as the default syntax for the runner; the default syntax will be substituted to the empty query in single runner mode. This is also used to display to the user what this runner can understand and how it can be used. The default syntax is automatically added to the list of registered syntaxes, there is no need to add it using addSyntax. Note that there can be only one default syntax; if called more than once, the last call will determine the default syntax. A default syntax (even trivial) is required to advertise single runner mode name="syntax" the syntax to register and to set as default
protected SetDefaultSyntax ( Plasma syntax ) : void
syntax Plasma
return void

SetHasRunOptions() protected method

Sets whether or not the runner has options for matches
protected SetHasRunOptions ( bool hasRunOptions ) : void
hasRunOptions bool
return void

SetIgnoredTypes() public method

Sets the types this runner will ignore name="types" OR'ed listed of ignored types
public SetIgnoredTypes ( uint types ) : void
types uint
return void

SetPriority() protected method

Sets the priority of the runner. Lower priority runners are executed only after higher priority runners.
protected SetPriority ( Plasma newPriority ) : void
newPriority Plasma
return void

SetSpeed() protected method

Sets the nominal speed of the runner. Only slow runners need to call this within their constructor because the default speed is NormalSpeed. Runners that use DBUS should call this within their constructors.
protected SetSpeed ( Plasma newSpeed ) : void
newSpeed Plasma
return void

SetSyntaxes() protected method

Sets the list of syntaxes; passing in an empty list effectively clears the syntaxes. name="the" syntaxes to register for this runner
protected SetSyntaxes ( List syns ) : void
syns List
return void

Syntaxes() public method

public Syntaxes ( ) : List
return List

priority() public method

The priority of the runner.
public priority ( ) : Plasma.AbstractRunner.Priority
return Plasma.AbstractRunner.Priority

speed() public method

The nominal speed of the runner.
public speed ( ) : Plasma.AbstractRunner.Speed
return Plasma.AbstractRunner.Speed