KDE 4.7 PyKDE API Reference
RunnerSyntax Class Reference
from PyKDE4.plasma import *
Namespace: Plasma
Detailed Description
RunnerSyntax
- Since:
- 4.3
Represents a query prototype that the runner accepts. These can be created and registered with AbstractRunner.addSyntax(Syntax &) to allow applications to show to the user what the runner is currently capable of doing
Methods | |
| __init__ (self, QString exampleQuery, QString description) | |
| __init__ (self, Plasma.RunnerSyntax other) | |
| addExampleQuery (self, QString exampleQuery) | |
| QString | description (self) |
| QStringList | exampleQueries (self) |
| QStringList | exampleQueriesWithTermDescription (self) |
| QString | searchTermDescription (self) |
| setDescription (self, QString description) | |
| setSearchTermDescription (self, QString description) | |
Method Documentation
| __init__ | ( | self, | ||
| QString | exampleQuery, | |||
| QString | description | |||
| ) |
Constructs a simple syntax object
- Parameters:
-
exampleQuery an example of the query, with :q: placed wherever search term text might appear. e.g. if the runner accepts "keyword some random text" then the value of this parameter should be "keyword :q:" descrition A description of what the described syntax does from the user's point of view.
| __init__ | ( | self, | ||
| Plasma.RunnerSyntax | other | |||
| ) |
Copy constructor
| addExampleQuery | ( | self, | ||
| QString | exampleQuery | |||
| ) |
Adds a synonymous example query to this Syntax. Some runners may accept multiple formulations of keywords to trigger the same behaviour. This allows the runner to show these relationships by grouping the example queries into one Syntax object
- Parameters:
-
exampleQuery an example of the query, with :q: placed wherever search term text might appear. e.g. if the runner accepts "keyword some random text" then the value of this parameter should be "keyword :q:"
| QString description | ( | self ) |
- Returns:
- the description of what the syntax does from the user's point of view
| QStringList exampleQueries | ( | self ) |
- Returns:
- the example queries associated with this Syntax object
| QStringList exampleQueriesWithTermDescription | ( | self ) |
- Returns:
- the example queries associated with this Syntax object, with the searchTermDescription replacing instances of :q:. Used for showing the queries in the user interface.
| QString searchTermDescription | ( | self ) |
- Returns:
- a description of the search term for this syntax
| setDescription | ( | self, | ||
| QString | description | |||
| ) |
Sets the description for the syntax, describing what it does from the user's point of view.
| setSearchTermDescription | ( | self, | ||
| QString | description | |||
| ) |
Sets the text that should be used to replace instances of :q: in the text. By default this is the generic phrase "search term". If the syntax expects a specific kind of input, it may be defined here. A syntax used by a runner that changes the brightness of the display may set this to "brightness" for instance.
