KDE 4.5 PyKDE API Reference
AppletScript Class Reference
from PyKDE4.plasma import *
Inherits: Plasma.ScriptEngine → QObject
Namespace: Plasma
Detailed Description
AppletScript plasma/scripting/appletscript.h <Plasma/Scripting/AppletScript>
Provides a restricted interface for scripted applets.
Signal Documentation
| popupEvent | ( | bool | popped | |
| ) |
- See also:
- PopupApplet
- Signal syntax:
QObject.connect(source, SIGNAL("popupEvent(bool)"), target_slot)
| saveState | ( | KConfigGroup | group | |
| ) |
- See also:
- Applet
- Signal syntax:
QObject.connect(source, SIGNAL("saveState(KConfigGroup&)"), target_slot)
Method Documentation
| __init__ | ( | self, | ||
| QObject | parent=0 | |||
| ) |
Default constructor for an AppletScript.
Subclasses should not attempt to access the Plasma.Applet associated with this AppletScript in the constructor. All such set up that requires the Applet itself should be done in the init() method.
| addStandardConfigurationPages | ( | self, | ||
| KConfigDialog | dialog | |||
| ) |
This method should be called after a scripting applet has added its own pages to a configuration dialog
- Since:
- 4.3.1
| Plasma.Applet applet | ( | self ) |
Returns the Plasma.Applet associated with this script component
| configChanged | ( | self ) |
Configure was changed.
| configNeedsSaving | ( | self ) |
- See also:
- Applet
| constraintsEvent | ( | self, | ||
| Plasma.Constraints | constraints | |||
| ) |
Called when any of the geometry constraints have been updated.
This is always called prior to painting and should be used as an opportunity to layout the widget, calculate sizings, etc.
Do not call update() from this method; an update() will be triggered at the appropriate time for the applet.
- Parameters:
-
constraints the type of constraints that were updated
| [QAction] contextualActions | ( | self ) |
Returns a list of context-related QAction instances.
- Returns:
- A list of actions. The default implementation returns an empty list.
| Plasma.DataEngine dataEngine | ( | self, | ||
| QString | engine | |||
| ) |
@arg engine name of the engine
- Returns:
- a data engine associated with this plasmoid
| KPluginInfo description | ( | self ) |
- Returns:
- the KPluginInfo associated with this plasmoid
| Plasma.Extender extender | ( | self ) |
- See also:
- Applet
| bool isRegisteredAsDragHandle | ( | self, | ||
| QGraphicsItem | item | |||
| ) |
- See also:
- Applet
| Plasma.Animation loadAnimationFromPackage | ( | self, | ||
| QString | name, | |||
| QObject | parent | |||
| ) |
Loads an animation from the applet package @arg animation the animation to load
- Returns:
- an Animation object on success, a NULL pointer on failure
- Since:
- 4.5
| QString mainScript | ( | self ) |
- Returns:
- absolute path to the main script file for this plasmoid
| Plasma.Package package | ( | self ) |
- Returns:
- the Package associated with this plasmoid which can be used to request resources, such as images and interface files.
| paintInterface | ( | self, | ||
| QPainter | painter, | |||
| QStyleOptionGraphicsItem | option, | |||
| QRect | contentsRect | |||
| ) |
Called when the script should paint the applet
- Parameters:
-
painter the QPainter to use option the style option containing such flags as selection, level of detail, etc contentsRect the rect to paint within; automatically adjusted for the background, if any
| registerAsDragHandle | ( | self, | ||
| QGraphicsItem | item | |||
| ) |
- See also:
- Applet
| setApplet | ( | self, | ||
| Plasma.Applet | applet | |||
| ) |
Sets the applet associated with this AppletScript
| setConfigurationRequired | ( | self, | ||
| bool | req, | |||
| QString | reason=QString() | |||
| ) |
- See also:
- Applet
| setFailedToLaunch | ( | self, | ||
| bool | failed, | |||
| QString | reason=QString() | |||
| ) |
- See also:
- Applet
| setHasConfigurationInterface | ( | self, | ||
| bool | hasInterface | |||
| ) |
Sets whether or not this script has a configuration interface or not
@arg hasInterface true if the applet is user configurable
| QPainterPath shape | ( | self ) |
Returns the shape of the widget, defaults to the bounding rect
| showConfigurationInterface | ( | self ) |
Show a configuration dialog.
| showMessage | ( | self, | ||
| QIcon | icon, | |||
| QString | message, | |||
| Plasma.MessageButtons | buttons | |||
| ) |
- See also:
- Applet
| QSizeF size | ( | self ) |
Returns the area within which contents can be painted.
| KConfigDialog standardConfigurationDialog | ( | self ) |
- Returns:
- a standard Plasma applet configuration dialog, ready to have pages added to it.
Note that the dialog returned is set to delete on close.
| unregisterAsDragHandle | ( | self, | ||
| QGraphicsItem | item | |||
| ) |
- See also:
- Applet
