#include <Plasma/Applet>

Inheritance diagram for Plasma::Applet:

Public Types
enum	{ Type = Plasma::AppletType }

enum	BackgroundHint { NoBackground = 0, StandardBackground = 1, TranslucentBackground = 2, DefaultBackground = StandardBackground }

typedef QHash< QString, Applet * >	Dict

typedef QList< Applet * >	List

Public Slots
virtual void	configChanged ()

virtual void	destroy ()

void	flushPendingConstraintsEvents ()

virtual void	init ()

bool	isPublished () const

bool	isUserConfiguring () const

void	lower ()

void	publish (Plasma::AnnouncementMethods methods, const QString &resourceName)

void	raise ()

void	runAssociatedApplication ()

void	setBusy (bool busy)

void	setImmutability (const ImmutabilityType immutable)

void	setStatus (const ItemStatus stat)

virtual void	showConfigurationInterface ()

void	showConfigurationInterface (QWidget *widget)

QVariantList	startupArguments () const

ItemStatus	status () const

void	unpublish ()

Signals
void	activate ()

void	appletDestroyed (Plasma::Applet *applet)

void	appletTransformedByUser ()

void	appletTransformedItself ()

void	configNeedsSaving ()

void	extenderItemRestored (Plasma::ExtenderItem *item)

void	geometryChanged ()

void	immutabilityChanged (Plasma::ImmutabilityType immutable)

void	messageButtonPressed (const Plasma::MessageButton button)

void	newStatus (Plasma::ItemStatus status)

void	releaseVisualFocus ()

void	sizeHintChanged (Qt::SizeHint which)

Public Member Functions
	Applet (QGraphicsItem *parent=0, const QString &serviceId=QString(), uint appletId=0)

	Applet (const KPluginInfo &info, QGraphicsItem *parent=0, uint appletId=0)

	Applet (QGraphicsItem *parent, const QString &serviceId, uint appletId, const QVariantList &args)

	~Applet ()

Q_INVOKABLE QAction *	action (QString name) const

void	addAction (QString name, QAction *action)

virtual void	addAssociatedWidget (QWidget *widget)

Plasma::AspectRatioMode	aspectRatioMode () const

QString	associatedApplication () const

KUrl::List	associatedApplicationUrls () const

BackgroundHints	backgroundHints () const

QString	category () const

KConfigGroup	config () const

KConfigGroup	config (const QString &group) const

ConfigLoader *	configScheme () const

bool	configurationRequired () const

Containment *	containment () const

Context *	context () const

virtual QList< QAction * >	contextualActions ()

virtual void	createConfigurationInterface (KConfigDialog *parent)

QStringList	customCategories ()

Q_INVOKABLE DataEngine *	dataEngine (const QString &name) const

bool	destroyed () const

QFont	font () const

virtual FormFactor	formFactor () const

KConfigGroup	globalConfig () const

KShortcut	globalShortcut () const

bool	hasAuthorization (const QString &constraint) const

bool	hasConfigurationInterface () const

bool	hasFailedToLaunch () const

bool	hasValidAssociatedApplication () const

QString	icon () const

uint	id () const

ImmutabilityType	immutability () const

virtual void	initExtenderItem (ExtenderItem *item)

bool	isBusy () const

bool	isContainment () const

virtual bool	isPopupShowing () const

virtual Location	location () const

QRectF	mapFromView (const QGraphicsView *view, const QRect &rect) const

QRect	mapToView (const QGraphicsView *view, const QRectF &rect) const

QString	name () const

const Package *	package () const

virtual void	paintInterface (QPainter painter, const QStyleOptionGraphicsItem option, const QRect &contentsRect)

void	paintWindowFrame (QPainter painter, const QStyleOptionGraphicsItem option, QWidget *widget)

QString	pluginName () const

QPoint	popupPosition (const QSize &s) const

QPoint	popupPosition (const QSize &s, Qt::AlignmentFlag alignment) const

virtual void	removeAssociatedWidget (QWidget *widget)

virtual void	restore (KConfigGroup &group)

virtual void	save (KConfigGroup &group) const

QRect	screenRect () const

void	setAspectRatioMode (Plasma::AspectRatioMode)

void	setAssociatedApplication (const QString &string)

void	setAssociatedApplicationUrls (const KUrl::List &urls)

void	setBackgroundHints (const BackgroundHints hints)

void	setCustomCategories (const QStringList &categories)

void	setGlobalShortcut (const KShortcut &shortcut)

bool	shouldConserveResources () const

int	type () const

void	updateConstraints (Plasma::Constraints constraints=Plasma::AllConstraints)

QGraphicsView *	view () const

Public Member Functions inherited from QGraphicsWidget
	QGraphicsWidget (QGraphicsItem *parent, QFlags< Qt::WindowType > wFlags)

	~QGraphicsWidget ()

QList< QAction * >	actions () const

void	addAction (QAction *action)

void	addActions (QList< QAction * > actions)

void	adjustSize ()

bool	autoFillBackground () const

virtual QRectF	boundingRect () const

bool	close ()

Qt::FocusPolicy	focusPolicy () const

QGraphicsWidget *	focusWidget () const

QFont	font () const

void	geometryChanged ()

virtual void	getContentsMargins (qreal left, qreal top, qreal right, qreal bottom) const

void	getWindowFrameMargins (qreal left, qreal top, qreal right, qreal bottom) const

int	grabShortcut (const QKeySequence &sequence, Qt::ShortcutContext context)

void	insertAction (QAction before, QAction action)

void	insertActions (QAction before, QList< QAction > actions)

bool	isActiveWindow () const

QGraphicsLayout *	layout () const

Qt::LayoutDirection	layoutDirection () const

QPalette	palette () const

QRectF	rect () const

void	releaseShortcut (int id)

void	removeAction (QAction *action)

void	resize (const QSizeF &size)

void	resize (qreal w, qreal h)

void	setAttribute (Qt::WidgetAttribute attribute, bool on)

void	setAutoFillBackground (bool enabled)

void	setContentsMargins (qreal left, qreal top, qreal right, qreal bottom)

void	setFocusPolicy (Qt::FocusPolicy policy)

void	setFont (const QFont &font)

virtual void	setGeometry (const QRectF &rect)

void	setGeometry (qreal x, qreal y, qreal w, qreal h)

void	setLayout (QGraphicsLayout *layout)

void	setLayoutDirection (Qt::LayoutDirection direction)

void	setPalette (const QPalette &palette)

void	setShortcutAutoRepeat (int id, bool enabled)

void	setShortcutEnabled (int id, bool enabled)

void	setStyle (QStyle *style)

void	setWindowFlags (QFlags< Qt::WindowType > wFlags)

void	setWindowFrameMargins (qreal left, qreal top, qreal right, qreal bottom)

void	setWindowTitle (const QString &title)

QSizeF	size () const

QStyle *	style () const

bool	testAttribute (Qt::WidgetAttribute attribute) const

void	unsetLayoutDirection ()

void	unsetWindowFrameMargins ()

Qt::WindowFlags	windowFlags () const

QRectF	windowFrameGeometry () const

QRectF	windowFrameRect () const

QString	windowTitle () const

Qt::WindowType	windowType () const

Public Member Functions inherited from QGraphicsObject
	QGraphicsObject (QGraphicsItem *parent)

void	enabledChanged ()

void	grabGesture (Qt::GestureType gesture, QFlags< Qt::GestureFlag > flags)

void	opacityChanged ()

void	parentChanged ()

void	rotationChanged ()

void	scaleChanged ()

void	ungrabGesture (Qt::GestureType gesture)

void	visibleChanged ()

void	xChanged ()

void	yChanged ()

void	zChanged ()

Public Member Functions inherited from QObject
	QObject (QObject *parent)

	QObject (QObject parent, const char name)

virtual	~QObject ()

bool	blockSignals (bool block)

QObject *	child (const char objName, const char inheritsClass, bool recursiveSearch) const

const QObjectList &	children () const

const char *	className () const

bool	connect (const QObject sender, const char signal, const char *method, Qt::ConnectionType type) const

void	deleteLater ()

void	destroyed (QObject *obj)

bool	disconnect (const QObject receiver, const char method)

bool	disconnect (const char signal, const QObject receiver, const char *method)

void	dumpObjectInfo ()

void	dumpObjectTree ()

QList< QByteArray >	dynamicPropertyNames () const

T	findChild (const QString &name) const

QList< T >	findChildren (const QRegExp &regExp) const

QList< T >	findChildren (const QString &name) const

bool	inherits (const char *className) const

void	insertChild (QObject *object)

void	installEventFilter (QObject *filterObj)

bool	isA (const char *className) const

bool	isWidgetType () const

void	killTimer (int id)

virtual const QMetaObject *	metaObject () const

void	moveToThread (QThread *targetThread)

const char *	name () const

const char *	name (const char *defaultName) const

QString	objectName () const

QObject *	parent () const

QVariant	property (const char *name) const

void	removeChild (QObject *object)

void	removeEventFilter (QObject *obj)

void	setName (const char *name)

void	setObjectName (const QString &name)

void	setParent (QObject *parent)

bool	setProperty (const char *name, const QVariant &value)

bool	signalsBlocked () const

int	startTimer (int interval)

QThread *	thread () const

Public Member Functions inherited from QGraphicsItem
	QGraphicsItem (QGraphicsItem *parent)

virtual	~QGraphicsItem ()

bool	acceptDrops () const

Qt::MouseButtons	acceptedMouseButtons () const

bool	acceptHoverEvents () const

bool	acceptsHoverEvents () const

bool	acceptTouchEvents () const

virtual void	advance (int phase)

virtual QRectF	boundingRect () const =0

QRegion	boundingRegion (const QTransform &itemToDeviceTransform) const

qreal	boundingRegionGranularity () const

CacheMode	cacheMode () const

QList< QGraphicsItem * >	childItems () const

QList< QGraphicsItem * >	children () const

QRectF	childrenBoundingRect () const

void	clearFocus ()

QPainterPath	clipPath () const

virtual bool	collidesWithItem (const QGraphicsItem *other, Qt::ItemSelectionMode mode) const

virtual bool	collidesWithPath (const QPainterPath &path, Qt::ItemSelectionMode mode) const

QList< QGraphicsItem * >	collidingItems (Qt::ItemSelectionMode mode) const

QGraphicsItem *	commonAncestorItem (const QGraphicsItem *other) const

virtual bool	contains (const QPointF &point) const

QCursor	cursor () const

QVariant	data (int key) const

QTransform	deviceTransform (const QTransform &viewportTransform) const

qreal	effectiveOpacity () const

void	ensureVisible (const QRectF &rect, int xmargin, int ymargin)

void	ensureVisible (qreal x, qreal y, qreal w, qreal h, int xmargin, int ymargin)

bool	filtersChildEvents () const

GraphicsItemFlags	flags () const

QGraphicsItem *	focusItem () const

QGraphicsItem *	focusProxy () const

void	grabKeyboard ()

void	grabMouse ()

QGraphicsEffect *	graphicsEffect () const

QGraphicsItemGroup *	group () const

bool	handlesChildEvents () const

bool	hasCursor () const

bool	hasFocus () const

void	hide ()

Qt::InputMethodHints	inputMethodHints () const

void	installSceneEventFilter (QGraphicsItem *filterItem)

bool	isActive () const

bool	isAncestorOf (const QGraphicsItem *child) const

bool	isBlockedByModalPanel (QGraphicsItem **blockingPanel) const

bool	isClipped () const

bool	isEnabled () const

bool	isObscured () const

bool	isObscured (const QRectF &rect) const

bool	isObscured (qreal x, qreal y, qreal w, qreal h) const

virtual bool	isObscuredBy (const QGraphicsItem *item) const

bool	isPanel () const

bool	isSelected () const

bool	isUnderMouse () const

bool	isVisible () const

bool	isVisibleTo (const QGraphicsItem *parent) const

bool	isWidget () const

bool	isWindow () const

QTransform	itemTransform (const QGraphicsItem other, bool ok) const

QPointF	mapFromItem (const QGraphicsItem *item, const QPointF &point) const

QPolygonF	mapFromItem (const QGraphicsItem *item, const QRectF &rect) const

QPolygonF	mapFromItem (const QGraphicsItem *item, const QPolygonF &polygon) const

QPainterPath	mapFromItem (const QGraphicsItem *item, const QPainterPath &path) const

QPointF	mapFromItem (const QGraphicsItem *item, qreal x, qreal y) const

QPolygonF	mapFromItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

QPointF	mapFromParent (const QPointF &point) const

QPolygonF	mapFromParent (const QRectF &rect) const

QPolygonF	mapFromParent (const QPolygonF &polygon) const

QPainterPath	mapFromParent (const QPainterPath &path) const

QPointF	mapFromParent (qreal x, qreal y) const

QPolygonF	mapFromParent (qreal x, qreal y, qreal w, qreal h) const

QPolygonF	mapFromScene (const QPolygonF &polygon) const

QPointF	mapFromScene (const QPointF &point) const

QPolygonF	mapFromScene (const QRectF &rect) const

QPainterPath	mapFromScene (const QPainterPath &path) const

QPointF	mapFromScene (qreal x, qreal y) const

QPolygonF	mapFromScene (qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectFromItem (const QGraphicsItem *item, const QRectF &rect) const

QRectF	mapRectFromItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectFromParent (const QRectF &rect) const

QRectF	mapRectFromParent (qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectFromScene (qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectFromScene (const QRectF &rect) const

QRectF	mapRectToItem (const QGraphicsItem *item, const QRectF &rect) const

QRectF	mapRectToItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectToParent (const QRectF &rect) const

QRectF	mapRectToParent (qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectToScene (const QRectF &rect) const

QRectF	mapRectToScene (qreal x, qreal y, qreal w, qreal h) const

QPointF	mapToItem (const QGraphicsItem *item, const QPointF &point) const

QPolygonF	mapToItem (const QGraphicsItem *item, const QRectF &rect) const

QPolygonF	mapToItem (const QGraphicsItem *item, const QPolygonF &polygon) const

QPainterPath	mapToItem (const QGraphicsItem *item, const QPainterPath &path) const

QPointF	mapToItem (const QGraphicsItem *item, qreal x, qreal y) const

QPolygonF	mapToItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

QPointF	mapToParent (const QPointF &point) const

QPolygonF	mapToParent (const QRectF &rect) const

QPainterPath	mapToParent (const QPainterPath &path) const

QPointF	mapToParent (qreal x, qreal y) const

QPolygonF	mapToParent (qreal x, qreal y, qreal w, qreal h) const

QPolygonF	mapToParent (const QPolygonF &polygon) const

QPolygonF	mapToScene (const QRectF &rect) const

QPainterPath	mapToScene (const QPainterPath &path) const

QPointF	mapToScene (qreal x, qreal y) const

QPolygonF	mapToScene (qreal x, qreal y, qreal w, qreal h) const

QPolygonF	mapToScene (const QPolygonF &polygon) const

QPointF	mapToScene (const QPointF &point) const

QMatrix	matrix () const

void	moveBy (qreal dx, qreal dy)

qreal	opacity () const

virtual QPainterPath	opaqueArea () const

virtual void	paint (QPainter painter, const QStyleOptionGraphicsItem option, QWidget *widget)=0

QGraphicsItem *	panel () const

PanelModality	panelModality () const

QGraphicsItem *	parentItem () const

QGraphicsObject *	parentObject () const

QGraphicsWidget *	parentWidget () const

QPointF	pos () const

void	removeSceneEventFilter (QGraphicsItem *filterItem)

void	resetMatrix ()

void	resetTransform ()

void	rotate (qreal angle)

qreal	rotation () const

void	scale (qreal sx, qreal sy)

qreal	scale () const

QGraphicsScene *	scene () const

QRectF	sceneBoundingRect () const

QMatrix	sceneMatrix () const

QPointF	scenePos () const

QTransform	sceneTransform () const

void	scroll (qreal dx, qreal dy, const QRectF &rect)

void	setAcceptDrops (bool on)

void	setAcceptedMouseButtons (QFlags< Qt::MouseButton > buttons)

void	setAcceptHoverEvents (bool enabled)

void	setAcceptsHoverEvents (bool enabled)

void	setAcceptTouchEvents (bool enabled)

void	setActive (bool active)

void	setBoundingRegionGranularity (qreal granularity)

void	setCacheMode (CacheMode mode, const QSize &logicalCacheSize)

void	setCursor (const QCursor &cursor)

void	setData (int key, const QVariant &value)

void	setEnabled (bool enabled)

void	setFiltersChildEvents (bool enabled)

void	setFlag (GraphicsItemFlag flag, bool enabled)

void	setFlags (QFlags< QGraphicsItem::GraphicsItemFlag > flags)

void	setFocus (Qt::FocusReason focusReason)

void	setFocusProxy (QGraphicsItem *item)

void	setGraphicsEffect (QGraphicsEffect *effect)

void	setGroup (QGraphicsItemGroup *group)

void	setHandlesChildEvents (bool enabled)

void	setInputMethodHints (QFlags< Qt::InputMethodHint > hints)

void	setMatrix (const QMatrix &matrix, bool combine)

void	setOpacity (qreal opacity)

void	setPanelModality (PanelModality panelModality)

void	setParentItem (QGraphicsItem *newParent)

void	setPos (const QPointF &pos)

void	setPos (qreal x, qreal y)

void	setRotation (qreal angle)

void	setScale (qreal factor)

void	setSelected (bool selected)

void	setToolTip (const QString &toolTip)

void	setTransform (const QTransform &matrix, bool combine)

void	setTransformations (const QList< QGraphicsTransform * > &transformations)

void	setTransformOriginPoint (qreal x, qreal y)

void	setTransformOriginPoint (const QPointF &origin)

void	setVisible (bool visible)

void	setX (qreal x)

void	setY (qreal y)

void	setZValue (qreal z)

void	shear (qreal sh, qreal sv)

void	show ()

void	stackBefore (const QGraphicsItem *sibling)

QGraphicsObject *	toGraphicsObject ()

const QGraphicsObject *	toGraphicsObject () const

QString	toolTip () const

QGraphicsItem *	topLevelItem () const

QGraphicsWidget *	topLevelWidget () const

QTransform	transform () const

QList< QGraphicsTransform * >	transformations () const

QPointF	transformOriginPoint () const

void	translate (qreal dx, qreal dy)

void	ungrabKeyboard ()

void	ungrabMouse ()

void	unsetCursor ()

void	update (qreal x, qreal y, qreal width, qreal height)

void	update (const QRectF &rect)

QGraphicsWidget *	window () const

qreal	x () const

qreal	y () const

qreal	zValue () const

Public Member Functions inherited from QGraphicsLayoutItem
	QGraphicsLayoutItem (QGraphicsLayoutItem *parent, bool isLayout)

virtual	~QGraphicsLayoutItem ()

QRectF	contentsRect () const

QSizeF	effectiveSizeHint (Qt::SizeHint which, const QSizeF &constraint) const

QRectF	geometry () const

QGraphicsItem *	graphicsItem () const

bool	isLayout () const

qreal	maximumHeight () const

QSizeF	maximumSize () const

qreal	maximumWidth () const

qreal	minimumHeight () const

QSizeF	minimumSize () const

qreal	minimumWidth () const

bool	ownedByLayout () const

QGraphicsLayoutItem *	parentLayoutItem () const

qreal	preferredHeight () const

QSizeF	preferredSize () const

qreal	preferredWidth () const

void	setMaximumHeight (qreal height)

void	setMaximumSize (const QSizeF &size)

void	setMaximumSize (qreal w, qreal h)

void	setMaximumWidth (qreal width)

void	setMinimumHeight (qreal height)

void	setMinimumSize (const QSizeF &size)

void	setMinimumSize (qreal w, qreal h)

void	setMinimumWidth (qreal width)

void	setParentLayoutItem (QGraphicsLayoutItem *parent)

void	setPreferredHeight (qreal height)

void	setPreferredSize (const QSizeF &size)

void	setPreferredSize (qreal w, qreal h)

void	setPreferredWidth (qreal width)

void	setSizePolicy (const QSizePolicy &policy)

void	setSizePolicy (QSizePolicy::Policy hPolicy, QSizePolicy::Policy vPolicy, QSizePolicy::ControlType controlType)

QSizePolicy	sizePolicy () const

Static Public Member Functions
static QString	category (const KPluginInfo &applet)

static QString	category (const QString &appletName)

static KPluginInfo::List	listAppletInfo (const QString &category=QString(), const QString &parentApp=QString())

static KPluginInfo::List	listAppletInfoForMimetype (const QString &mimetype)

static KPluginInfo::List	listAppletInfoForUrl (const QUrl &url)

static QStringList	listCategories (const QString &parentApp=QString(), bool visibleOnly=true)

static Applet *	load (const QString &name, uint appletId=0, const QVariantList &args=QVariantList())

static Applet *	load (const KPluginInfo &info, uint appletId=0, const QVariantList &args=QVariantList())

static Applet *	loadPlasmoid (const QString &path, uint appletId=0, const QVariantList &args=QVariantList())

static PackageStructure::Ptr	packageStructure ()

Static Public Member Functions inherited from QGraphicsWidget
void	setTabOrder (QGraphicsWidget first, QGraphicsWidget second)

Static Public Member Functions inherited from QObject
bool	connect (const QObject sender, const char signal, const QObject receiver, const char method, Qt::ConnectionType type)

bool	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type)

bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char method)

bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method)

QString	tr (const char sourceText, const char disambiguation, int n)

QString	trUtf8 (const char sourceText, const char disambiguation, int n)

Protected Member Functions
	Applet (QObject *parent, const QVariantList &args)

virtual void	constraintsEvent (Plasma::Constraints constraints)

bool	eventFilter (QObject o, QEvent e)

Extender *	extender () const

void	focusInEvent (QFocusEvent *event)

void	hoverEnterEvent (QGraphicsSceneHoverEvent *event)

void	hoverLeaveEvent (QGraphicsSceneHoverEvent *event)

bool	isRegisteredAsDragHandle (QGraphicsItem *item)

QVariant	itemChange (GraphicsItemChange change, const QVariant &value)

void	mouseMoveEvent (QGraphicsSceneMouseEvent *event)

void	registerAsDragHandle (QGraphicsItem *item)

void	resizeEvent (QGraphicsSceneResizeEvent *event)

virtual void	saveState (KConfigGroup &config) const

bool	sceneEventFilter (QGraphicsItem watched, QEvent event)

void	setConfigurationRequired (bool needsConfiguring, const QString &reason=QString())

void	setFailedToLaunch (bool failed, const QString &reason=QString())

void	setHasConfigurationInterface (bool hasInterface)

QPainterPath	shape () const

void	showMessage (const QIcon &icon, const QString &message, const Plasma::MessageButtons buttons)

QSizeF	sizeHint (Qt::SizeHint which, const QSizeF &constraint=QSizeF()) const

void	timerEvent (QTimerEvent *event)

void	unregisterAsDragHandle (QGraphicsItem *item)

Protected Member Functions inherited from QGraphicsWidget
virtual void	changeEvent (QEvent *event)

virtual void	closeEvent (QCloseEvent *event)

virtual bool	event (QEvent *event)

virtual bool	focusNextPrevChild (bool next)

virtual void	focusOutEvent (QFocusEvent *event)

virtual void	grabKeyboardEvent (QEvent *event)

virtual void	grabMouseEvent (QEvent *event)

virtual void	hideEvent (QHideEvent *event)

virtual void	hoverMoveEvent (QGraphicsSceneHoverEvent *event)

virtual void	initStyleOption (QStyleOption *option) const

virtual void	moveEvent (QGraphicsSceneMoveEvent *event)

virtual void	polishEvent ()

virtual bool	sceneEvent (QEvent *event)

virtual void	showEvent (QShowEvent *event)

virtual void	ungrabKeyboardEvent (QEvent *event)

virtual void	ungrabMouseEvent (QEvent *event)

virtual void	updateGeometry ()

virtual bool	windowFrameEvent (QEvent *event)

virtual Qt::WindowFrameSection	windowFrameSectionAt (const QPointF &pos) const

Protected Member Functions inherited from QGraphicsObject
void	updateMicroFocus ()

Protected Member Functions inherited from QObject
bool	checkConnectArgs (const char signal, const QObject object, const char *method)

virtual void	childEvent (QChildEvent *event)

virtual void	connectNotify (const char *signal)

virtual void	customEvent (QEvent *event)

virtual void	disconnectNotify (const char *signal)

int	receivers (const char *signal) const

QObject *	sender () const

int	senderSignalIndex () const

Protected Member Functions inherited from QGraphicsItem
virtual void	contextMenuEvent (QGraphicsSceneContextMenuEvent *event)

virtual void	dragEnterEvent (QGraphicsSceneDragDropEvent *event)

virtual void	dragLeaveEvent (QGraphicsSceneDragDropEvent *event)

virtual void	dragMoveEvent (QGraphicsSceneDragDropEvent *event)

virtual void	dropEvent (QGraphicsSceneDragDropEvent *event)

virtual void	inputMethodEvent (QInputMethodEvent *event)

virtual QVariant	inputMethodQuery (Qt::InputMethodQuery query) const

virtual void	keyPressEvent (QKeyEvent *event)

virtual void	keyReleaseEvent (QKeyEvent *event)

virtual void	mouseDoubleClickEvent (QGraphicsSceneMouseEvent *event)

virtual void	mousePressEvent (QGraphicsSceneMouseEvent *event)

virtual void	mouseReleaseEvent (QGraphicsSceneMouseEvent *event)

void	prepareGeometryChange ()

void	updateMicroFocus ()

virtual void	wheelEvent (QGraphicsSceneWheelEvent *event)

Protected Member Functions inherited from QGraphicsLayoutItem
void	setGraphicsItem (QGraphicsItem *item)

void	setOwnedByLayout (bool ownership)

virtual QSizeF	sizeHint (Qt::SizeHint which, const QSizeF &constraint) const =0

Properties
BackgroundHints	backgroundHints

bool	busy

QString	category

bool	configurationRequired

QRectF	geometry

bool	hasConfigurationInterface

bool	hasFailedToLaunch

uint	id

ImmutabilityType	immutability

bool	isBusy

QString	name

QString	pluginName

bool	shouldConserveResources

bool	userConfiguring

Properties inherited from QGraphicsWidget
	autoFillBackground

	focusPolicy

	font

	geometry

	layout

	layoutDirection

	maximumSize

	minimumSize

	palette

	preferredSize

	size

	sizePolicy

	windowFlags

	windowTitle

Properties inherited from QGraphicsObject
	effect

	enabled

	opacity

	parent

	pos

	rotation

	scale

	transformOriginPoint

	visible

	x

	y

	z

Properties inherited from QObject
	objectName

Additional Inherited Members
Public Attributes inherited from QGraphicsItem
typedef	GraphicsItemFlags

Static Protected Member Functions inherited from QObject
QByteArray	normalizeSignalSlot (const char *signalSlot)

Detailed Description

The base Applet class.

Applet provides several important roles for add-ons widgets in Plasma.

First, it is the base class for the plugin system and therefore is the interface to applets for host applications. It also handles the life time management of data engines (e.g. all data engines accessed via Applet::dataEngine(const QString&) are properly deref'd on Applet destruction), background painting (allowing for consistent and complex look and feel in just one line of code for applets), loading and starting of scripting support for each applet, providing access to the associated plasmoid package (if any) and access to configuration data.

See techbase.kde.org for tutorials on writing Applets using this class.

Definition at line 77 of file applet.h.

Member Typedef Documentation

typedef QHash<QString, Applet*> Plasma::Applet::Dict

Definition at line 98 of file applet.h.

typedef QList<Applet*> Plasma::Applet::List

Definition at line 97 of file applet.h.

Member Enumeration Documentation

anonymous enum

Enumerator
Type

Definition at line 548 of file applet.h.

enum Plasma::Applet::BackgroundHint

Description on how draw a background for the applet.

Enumerator
NoBackground	Not drawing a background under the applet, the applet has its own implementation.
StandardBackground	The standard background from the theme is drawn.
TranslucentBackground	An alternate version of the background is drawn, usually more translucent.
DefaultBackground	Default settings: both standard background.

Definition at line 103 of file applet.h.

Constructor & Destructor Documentation

Plasma::Applet::~Applet ( )

Definition at line 207 of file applet.cpp.

Plasma::Applet::Applet	(	QGraphicsItem *	parent = `0`,
		const QString &	serviceId = `QString()`,
		uint	appletId = `0`
	)

explicit

Parameters

parent	the QGraphicsItem this applet is parented to
serviceId	the name of the .desktop file containing the information about the widget
appletId	a unique id used to differentiate between multiple instances of the same Applet type

Definition at line 136 of file applet.cpp.

Plasma::Applet::Applet	(	const KPluginInfo &	info,
		QGraphicsItem *	parent = `0`,
		uint	appletId = `0`
	)

explicit

Parameters

parent	the QGraphicsItem this applet is parented to
info	the plugin information object for this Applet
appletId	a unique id used to differentiate between multiple instances of the same Applet type

Since: 4.6

Definition at line 127 of file applet.cpp.

Plasma::Applet::Applet	(	QGraphicsItem *	parent,
		const QString &	serviceId,
		uint	appletId,
		const QVariantList &	args
	)

explicit

Parameters

parent	the QGraphicsItem this applet is parented to
serviceId	the name of the .desktop file containing the information about the widget
appletId	a unique id used to differentiate between multiple instances of the same Applet type
args	a list of strings containing two entries: the service id and the applet id

Since: 4.3

Definition at line 145 of file applet.cpp.

Plasma::Applet::Applet	(	QObject *	parent,
		const QVariantList &	args
	)

protected

This constructor is to be used with the plugin loading systems found in KPluginInfo and KService.

The argument list is expected to have two elements: the KService service ID for the desktop entry and an applet ID which must be a base 10 number.

Parameters

parent	a QObject parent; you probably want to pass in 0
args	a list of strings containing two entries: the service id and the applet id

Definition at line 169 of file applet.cpp.

Member Function Documentation

QAction * Plasma::Applet::action ( QString name ) const

Returns the QAction with the given name from our collection.

Definition at line 1390 of file applet.cpp.

void Plasma::Applet::activate ( )

signal

Emitted when activation is requested due to, for example, a global keyboard shortcut.

By default the wiget is given focus.

void Plasma::Applet::addAction	(	QString	name,
		QAction *	action
	)

Adds the action to our collection under the given name.

Definition at line 1395 of file applet.cpp.

void Plasma::Applet::addAssociatedWidget ( QWidget * widget )

virtual

associate actions with this widget, including ones added after this call.

needed to make keyboard shortcuts work.

Reimplemented in Plasma::Containment.

Definition at line 1608 of file applet.cpp.

void Plasma::Applet::appletDestroyed ( Plasma::Applet * applet )

signal

Emitted when the applet is deleted.

void Plasma::Applet::appletTransformedByUser ( )

signal

Emitted when the user completes a transformation of the applet.

void Plasma::Applet::appletTransformedItself ( )

signal

Emitted when the applet changes its own geometry or transform.

Plasma::AspectRatioMode Plasma::Applet::aspectRatioMode ( ) const

Returns: the preferred aspect ratio mode for placement and resizing

Definition at line 1631 of file applet.cpp.

QString Plasma::Applet::associatedApplication ( ) const

Returns: the application associated to this applet

Since: 4.4

Definition at line 2247 of file applet.cpp.

KUrl::List Plasma::Applet::associatedApplicationUrls ( ) const

Returns: the urls associated to this applet

Since: 4.4

Definition at line 2252 of file applet.cpp.

BackgroundHints Plasma::Applet::backgroundHints ( ) const

Returns: BackgroundHints flags combination telling if the standard background is shown and if it has a drop shadow

QString Plasma::Applet::category ( const KPluginInfo & applet )

static

Get the category of the given applet.

Parameters

applet a KPluginInfo object for the applet

Definition at line 870 of file applet.cpp.

QString Plasma::Applet::category ( const QString & appletName )

static

Get the category of the given applet.

Parameters

appletName the name of the applet

Definition at line 875 of file applet.cpp.

QString Plasma::Applet::category ( ) const

Returns the category the applet is in, as specified in the .desktop file.

KConfigGroup Plasma::Applet::config ( ) const

Returns the KConfigGroup to access the applets configuration.

This config object will write to an instance specific config file named <appletname><instanceid>rc in the Plasma appdata directory.

Definition at line 450 of file applet.cpp.

KConfigGroup Plasma::Applet::config ( const QString & group ) const

Returns a config group with the name provided.

This ensures that the group name is properly namespaced to avoid collision with other applets that may be sharing this config file

Parameters

group the name of the group to access

Definition at line 440 of file applet.cpp.

void Plasma::Applet::configChanged ( )

virtualslot

Called when applet configuration values have changed.

Definition at line 2198 of file applet.cpp.

void Plasma::Applet::configNeedsSaving ( )

signal

Emitted when an applet has changed values in its configuration and wishes for them to be saved at the next save point.

As this implies disk activity, this signal should be used with care.

Note: This does not need to be emitted from saveState by individual applets.

ConfigLoader * Plasma::Applet::configScheme ( ) const

Returns the config skeleton object from this applet's package, if any.

Returns: config skeleton object, or 0 if none

Definition at line 675 of file applet.cpp.

bool Plasma::Applet::configurationRequired ( ) const

Returns: true if the applet currently needs to be configured, otherwise, false

void Plasma::Applet::constraintsEvent ( Plasma::Constraints constraints )

protectedvirtual

Definition at line 755 of file applet.cpp.

Containment * Plasma::Applet::containment ( ) const

Returns: the Containment, if any, this applet belongs to

Definition at line 1518 of file applet.cpp.

Context * Plasma::Applet::context ( ) const

Returns the workspace context which the applet is operating in.

Definition at line 1624 of file applet.cpp.

QList< QAction * > Plasma::Applet::contextualActions ( )

virtual

Returns a list of context-related QAction instances.

This is used e.g. within the DesktopView to display a contextmenu.

Returns: A list of actions. The default implementation returns an empty list.

Definition at line 1384 of file applet.cpp.

void Plasma::Applet::createConfigurationInterface ( KConfigDialog * parent )

virtual

Reimplement this method so provide a configuration interface, parented to the supplied widget.

Ownership of the widgets is passed to the parent widget.

Typically one would add custom pages to the config dialog parent and then connect to the applyClicked() and okClicked() signals or parent to react on config changes:

connect(parent, SIGNAL(applyClicked()), this, SLOT(myConfigAccepted()));

connect(parent, SIGNAL(okClicked()), this, SLOT(myConfigAccepted()));

With this approach it makes sense to store the custom pages in member variables to make their fields accessible from the myConfigAccepted() slot.

Use config() to store your configuration.

Parameters

parent the dialog which is the parent of the configuration widgets

Definition at line 2208 of file applet.cpp.

QStringList Plasma::Applet::customCategories ( )

Returns: the list of custom categories known to libplasma

Since: 4.3

Definition at line 2399 of file applet.cpp.

DataEngine * Plasma::Applet::dataEngine ( const QString & name ) const

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.

Parameters

name	Name of the data engine to load

Returns: pointer to the data engine if it was loaded, or an invalid data engine if the requested engine could not be loaded

Definition at line 680 of file applet.cpp.

void Plasma::Applet::destroy ( )

virtualslot

Destroys the applet; it will be removed nicely and deleted.

Its configuration will also be deleted.

Definition at line 479 of file applet.cpp.

bool Plasma::Applet::destroyed ( ) const

Returns: true if destroy() was called; useful for Applets which should avoid certain tasks if they are about to be deleted permanently

Definition at line 497 of file applet.cpp.

bool Plasma::Applet::eventFilter	(	QObject *	o,
		QEvent *	e
	)

protectedvirtual

event filter; used for focus watching

Reimplemented from QObject.

Reimplemented in Plasma::PopupApplet.

Definition at line 1774 of file applet.cpp.

Extender * Plasma::Applet::extender ( ) const

protected

Returns: the extender of this applet.

Definition at line 782 of file applet.cpp.

void Plasma::Applet::extenderItemRestored ( Plasma::ExtenderItem * item )

signal

Emitted when an ExtenderItem in a scripting applet needs to be initialized.

void Plasma::Applet::flushPendingConstraintsEvents ( )

slot

Sends all pending contraints updates to the applet.

Will usually be called automatically, but can also be called manually if needed.

Definition at line 1204 of file applet.cpp.

void Plasma::Applet::focusInEvent ( QFocusEvent * event )

protectedvirtual

Reimplemented from QGraphicsItem.

Reimplemented from QGraphicsWidget.

Definition at line 1869 of file applet.cpp.

QFont Plasma::Applet::font ( ) const

Returns: the font currently set for this widget

Definition at line 829 of file applet.cpp.

FormFactor Plasma::Applet::formFactor ( ) const

virtual

Returns the current form factor the applet is being displayed in.

See also: Plasma::FormFactor

Definition at line 1479 of file applet.cpp.

void Plasma::Applet::geometryChanged ( )

signal

Emitted whenever the applet makes a geometry change, so that views can coordinate themselves with these changes if they desire.

KConfigGroup Plasma::Applet::globalConfig ( ) const

Returns a KConfigGroup object to be shared by all applets of this type.

This config object will write to an applet-specific config object named plasma_<appletname>rc in the local config directory.

Definition at line 463 of file applet.cpp.

KShortcut Plasma::Applet::globalShortcut ( ) const

Returns: the global shortcut associated with this wiget, or an empty shortcut if no global shortcut is associated.

Definition at line 1594 of file applet.cpp.

bool Plasma::Applet::hasAuthorization ( const QString & constraint ) const

Returns true if the applet is allowed to perform functions covered by the given constraint eg.

hasAuthorization("FileDialog") returns true if applets are allowed to show filedialogs.

Since: 4.3

Definition at line 2215 of file applet.cpp.

bool Plasma::Applet::hasConfigurationInterface ( ) const

Returns: true if this plasmoid provides a GUI configuration

bool Plasma::Applet::hasFailedToLaunch ( ) const

If for some reason, the applet fails to get up on its feet (the library couldn't be loaded, necessary hardware support wasn't found, etc..) this method returns true.

bool Plasma::Applet::hasValidAssociatedApplication ( ) const

Returns: true if the applet has a valid associated application or urls

Since: 4.4

Definition at line 2264 of file applet.cpp.

void Plasma::Applet::hoverEnterEvent ( QGraphicsSceneHoverEvent * event )

protectedvirtual

Reimplemented from QGraphicsLayoutItem.

Reimplemented from QGraphicsItem.

Definition at line 2543 of file applet.cpp.

void Plasma::Applet::hoverLeaveEvent ( QGraphicsSceneHoverEvent * event )

protectedvirtual

Reimplemented from QGraphicsLayoutItem.

Reimplemented from QGraphicsWidget.

Definition at line 2548 of file applet.cpp.

QString Plasma::Applet::icon ( ) const

Returns the icon related to this applet.

Definition at line 834 of file applet.cpp.

uint Plasma::Applet::id ( ) const

Returns: the id of this applet

ImmutabilityType Plasma::Applet::immutability ( ) const

Returns: The type of immutability of this applet

void Plasma::Applet::immutabilityChanged ( Plasma::ImmutabilityType immutable )

signal

Emitted when the immutability changes.

Since: 4.4

void Plasma::Applet::init ( )

virtualslot

This method is called once the applet is loaded and added to a Corona.

If the applet requires a QGraphicsScene or has an particularly intensive set of initialization routines to go through, consider implementing it in this method instead of the constructor.

Note: paintInterface may get called before init() depending on initialization order. Painting is managed by the canvas (QGraphisScene), and may schedule a paint event prior to init() being called.

Reimplemented in Plasma::Containment.

Definition at line 243 of file applet.cpp.

void Plasma::Applet::initExtenderItem ( ExtenderItem * item )

virtual

Gets called when an extender item has to be initialized after a plasma restart.

If you create ExtenderItems in your applet, you should implement this function to again create the widget that should be shown in this extender item. This function might look something like this:

SuperCoolWidget *widget = new SuperCoolWidget();
dataEngine("engine")->connectSource(item->config("dataSourceName"), widget);
item->setWidget(widget);

You can also add one or more custom qactions to this extender item in this function.

Note that by default, not all ExtenderItems are persistent. Only items that are detached, will have their configuration stored when plasma exits.

Definition at line 769 of file applet.cpp.

bool Plasma::Applet::isBusy ( ) const

Returns: true if the applet is busy and is showing an indicator widget for that

bool Plasma::Applet::isContainment ( ) const

Returns: true if this Applet is currently being used as a Containment, false otherwise

Definition at line 2647 of file applet.cpp.

bool Plasma::Applet::isPopupShowing ( ) const

virtual

Returns: true is there is a popup assoiated with this Applet showing, such as the dialog of a PopupApplet. May be reimplemented for custom popup implementations.

Reimplemented in Plasma::PopupApplet.

Definition at line 1603 of file applet.cpp.

bool Plasma::Applet::isPublished ( ) const

slot

Definition at line 1711 of file applet.cpp.

bool Plasma::Applet::isRegisteredAsDragHandle ( QGraphicsItem * item )

protected

Parameters

item	the item to look for if it is registered or not

Returns: true if it is registered, false otherwise

Definition at line 1670 of file applet.cpp.

bool Plasma::Applet::isUserConfiguring ( ) const

slot

Returns: true when the configuration interface is being shown

Since: 4.5

Definition at line 1893 of file applet.cpp.

QVariant Plasma::Applet::itemChange	(	GraphicsItemChange	change,
		const QVariant &	value
	)

protectedvirtual

Reimplemented from QGraphicsItem.

Reimplemented from QGraphicsWidget.

Reimplemented in Plasma::Containment.

Definition at line 2436 of file applet.cpp.

KPluginInfo::List Plasma::Applet::listAppletInfo	(	const QString &	category = `QString()`,
		const QString &	parentApp = `QString()`
	)

static

Returns a list of all known applets.

This may skip applets based on security settings and ExcludeCategories in the application's config.

Parameters

category	Only applets matchin this category will be returned. Useful in conjunction with knownCategories. If "Misc" is passed in, then applets without a Categories= entry are also returned. If an empty string is passed in, all applets are returned.
parentApp	the application to filter applets on. Uses the X-KDE-ParentApp entry (if any) in the plugin info. The default value of QString() will result in a list containing only applets not specifically registered to an application.

Returns: list of applets

Definition at line 2312 of file applet.cpp.

KPluginInfo::List Plasma::Applet::listAppletInfoForMimetype ( const QString & mimetype )

static

Returns a list of all known applets associated with a certain mimetype.

Returns: list of applets

Definition at line 2317 of file applet.cpp.

KPluginInfo::List Plasma::Applet::listAppletInfoForUrl ( const QUrl & url )

static

Returns a list of all known applets associated with a certain URL.

Since: 4.4

Returns: list of applets

Definition at line 2327 of file applet.cpp.

QStringList Plasma::Applet::listCategories	(	const QString &	parentApp = `QString()`,
		bool	visibleOnly = `true`
	)

static

Returns a list of all the categories used by installed applets.

Parameters

parentApp the application to filter applets on. Uses the X-KDE-ParentApp entry (if any) in the plugin info. The default value of QString() will result in a list containing only applets not specifically registered to an application.

Returns: list of categories

Parameters

visibleOnly true if it should only return applets that are marked as visible

Definition at line 2351 of file applet.cpp.

Applet * Plasma::Applet::load	(	const QString &	name,
		uint	appletId = `0`,
		const QVariantList &	args = `QVariantList()`
	)

static

Attempts to load an applet.

Returns a pointer to the applet if successful. The caller takes responsibility for the applet, including deleting it when no longer needed.

Parameters

name	the plugin name, as returned by KPluginInfo::pluginName()
appletId	unique ID to assign the applet, or zero to have one assigned automatically.
args	to send the applet extra arguments

Returns: a pointer to the loaded applet, or 0 on load failure

Definition at line 2422 of file applet.cpp.

Applet * Plasma::Applet::load	(	const KPluginInfo &	info,
		uint	appletId = `0`,
		const QVariantList &	args = `QVariantList()`
	)

static

Attempts to load an applet.

Returns a pointer to the applet if successful. The caller takes responsibility for the applet, including deleting it when no longer needed.

Parameters

info	KPluginInfo object for the desired applet
appletId	unique ID to assign the applet, or zero to have one assigned automatically.
args	to send the applet extra arguments

Returns: a pointer to the loaded applet, or 0 on load failure

Definition at line 2427 of file applet.cpp.

Applet * Plasma::Applet::loadPlasmoid	(	const QString &	path,
		uint	appletId = `0`,
		const QVariantList &	args = `QVariantList()`
	)

static

Attempts to load an applet from a package.

Returns a pointer to the applet if successful. The caller takes responsibility for the applet, including deleting it when no longer needed.

Parameters

path	the path to the package
appletId	unique ID to assign the applet, or zero to have one assigned automatically.
args	to send the applet extra arguments

Returns: a pointer to the loaded applet, or 0 on load failure

Since: 4.3

Definition at line 2404 of file applet.cpp.

Location Plasma::Applet::location ( ) const

virtual

Returns the location of the scene which is displaying applet.

See also: Plasma::Location

Definition at line 1618 of file applet.cpp.

void Plasma::Applet::lower ( )

slot

Causes this applet to lower below all the other applets.

Definition at line 2622 of file applet.cpp.

QRectF Plasma::Applet::mapFromView	(	const QGraphicsView *	view,
		const QRect &	rect
	)		const

Maps a QRect from a view's coordinates to local coordinates.

Parameters

view	the view from which rect should be mapped
rect	the rect to be mapped

Definition at line 725 of file applet.cpp.

QRect Plasma::Applet::mapToView	(	const QGraphicsView *	view,
		const QRectF &	rect
	)		const

Maps a QRectF from local coordinates to a view's coordinates.

Parameters

view	the view to which rect should be mapped
rect	the rect to be mapped

Definition at line 731 of file applet.cpp.

void Plasma::Applet::messageButtonPressed ( const Plasma::MessageButton button )

signal

Emitted when the user clicked on a button of the message overlay.

See also: showMessage; Plasma::MessageButton

Since: 4.3

void Plasma::Applet::mouseMoveEvent ( QGraphicsSceneMouseEvent * event )

protectedvirtual

manage the mouse movement to drag the applet around

Reimplemented from QGraphicsItem.

Reimplemented in Plasma::Containment.

Definition at line 1862 of file applet.cpp.

QString Plasma::Applet::name ( ) const

Returns the user-visible name for the applet, as specified in the .desktop file.

Returns: the user-visible name for the applet.

void Plasma::Applet::newStatus ( Plasma::ItemStatus status )

signal

Emitted when the applet status changes.

Since: 4.4

const Package * Plasma::Applet::package ( ) const

Accessor for the associated Package object if any.

Generally, only Plasmoids come in a Package.

Returns: the Package object, or 0 if none

Definition at line 691 of file applet.cpp.

PackageStructure::Ptr Plasma::Applet::packageStructure ( )

static

Returns: a package structure representing an Applet

Definition at line 234 of file applet.cpp.

void Plasma::Applet::paintInterface	(	QPainter *	painter,
		const QStyleOptionGraphicsItem *	option,
		const QRect &	contentsRect
	)

virtual

This method is called when the interface should be painted.

Parameters

painter	the QPainter to use to do the paintiner
option	the style options object
contentsRect	the rect to paint within; automatically adjusted for the background, if any

Definition at line 1470 of file applet.cpp.

void Plasma::Applet::paintWindowFrame	(	QPainter *	painter,
		const QStyleOptionGraphicsItem *	option,
		QWidget *	widget
	)

virtual

Reimplemented from QGraphicsWidget.

Definition at line 994 of file applet.cpp.

QString Plasma::Applet::pluginName ( ) const

Returns the plugin name for the applet.

QPoint Plasma::Applet::popupPosition ( const QSize & s ) const

Reccomended position for a popup window like a menu or a tooltip given its size.

Parameters

s	size of the popup

Returns: reccomended position

Definition at line 737 of file applet.cpp.

QPoint Plasma::Applet::popupPosition	(	const QSize &	s,
		Qt::AlignmentFlag	alignment
	)		const

Since: 4.4 Reccomended position for a popup window like a menu or a tooltip given its size

Parameters

s	size of the popup
alignment	alignment of the popup, valid flags are Qt::AlignLeft, Qt::AlignRight and Qt::AlignCenter

Returns: reccomended position

Definition at line 742 of file applet.cpp.

void Plasma::Applet::publish	(	Plasma::AnnouncementMethods	methods,
		const QString &	resourceName
	)

slot

Publishes and optionally announces this applet on the network for remote access.

Parameters

methods	the methods to use for announcing this applet.
resourceName	the name under which this applet will be published (has to be unique for each machine)

Definition at line 1680 of file applet.cpp.

void Plasma::Applet::raise ( )

slot

Causes this applet to raise above all other applets.

Definition at line 2617 of file applet.cpp.

void Plasma::Applet::registerAsDragHandle ( QGraphicsItem * item )

protected

Register the widgets that manage mouse clicks but you still want to be able to drag the applet around when holding the mouse pointer on that widget.

Calling this results in an eventFilter being places on the widget.

Parameters

item	the item to watch for mouse move

Definition at line 1647 of file applet.cpp.

void Plasma::Applet::releaseVisualFocus ( )

signal

This signal indicates that an application launch, window creation or window focus event was triggered.

This is used, for instance, to ensure that the Dashboard view in Plasma Desktop hides when such an event is triggered by an item it is displaying.

void Plasma::Applet::removeAssociatedWidget ( QWidget * widget )

virtual

un-associate actions from this widget, including ones added after this call.

needed to make keyboard shortcuts work.

Reimplemented in Plasma::Containment.

Definition at line 1613 of file applet.cpp.

void Plasma::Applet::resizeEvent ( QGraphicsSceneResizeEvent * event )

protectedvirtual

Reimplemented from QGraphicsItem.

Reimplemented from QGraphicsWidget.

Reimplemented in Plasma::Containment.

Definition at line 1879 of file applet.cpp.

void Plasma::Applet::restore ( KConfigGroup & group )

virtual

Restores state information about this applet saved previously in save(KConfigGroup&).

This method does not need to be reimplmented by Applet subclasses, but can be useful for Applet specializations (such as Containment) to do so.

Reimplemented in Plasma::Containment.

Definition at line 310 of file applet.cpp.

void Plasma::Applet::runAssociatedApplication ( )

slot

Open the application associated to this applet, if it's not set but some urls are, open those urls with the proper application for their mimetype.

See also: setAssociatedApplication(); setAssociatedApplicationUrls()

Since: 4.4

Definition at line 2257 of file applet.cpp.

void Plasma::Applet::save ( KConfigGroup & group ) const

virtual

Saves state information about this applet that will be accessed when next instantiated in the restore(KConfigGroup&) method.

This method does not need to be reimplmented by Applet subclasses, but can be useful for Applet specializations (such as Containment) to do so.

Applet subclasses may instead want to reimplement saveState().

Reimplemented in Plasma::Containment.

Definition at line 260 of file applet.cpp.

void Plasma::Applet::saveState ( KConfigGroup & config ) const

protectedvirtual

When called, the Applet should write any information needed as part of the Applet's running state to the configuration object in config() and/or globalConfig().

Applets that always sync their settings/state with the config objects when these settings/states change do not need to reimplement this method.

Definition at line 426 of file applet.cpp.

bool Plasma::Applet::sceneEventFilter	(	QGraphicsItem *	watched,
		QEvent *	event
	)

protectedvirtual

scene event filter; used to manage applet dragging

Reimplemented from QGraphicsItem.

Reimplemented in Plasma::Containment.

Definition at line 1779 of file applet.cpp.

QRect Plasma::Applet::screenRect ( ) const

This method returns screen coordinates for the widget; this method can be somewhat expensive and should ONLY be called when screen coordinates are required.

For example when positioning top level widgets on top of the view to create the appearance of unit. This should NOT be used for popups (

See also: popupPosition) or for normal widget use (use Plasma:: widgets or QGraphicsProxyWidget instead).

Returns: a rect of the applet in screen coordinates.

Definition at line 2598 of file applet.cpp.

void Plasma::Applet::setAspectRatioMode ( Plasma::AspectRatioMode mode )

Sets the preferred aspect ratio mode for placement and resizing.

Definition at line 1636 of file applet.cpp.

void Plasma::Applet::setAssociatedApplication ( const QString & string )

Sets an application associated to this applet, that will be regarded as a full view of what is represented in the applet.

Parameters

string

the name of the application. it can be

a name understood by KService::serviceByDesktopName (e.g. "konqueror")
a command in $PATH
or an absolute path to an executable

Since: 4.4

Definition at line 2221 of file applet.cpp.

void Plasma::Applet::setAssociatedApplicationUrls ( const KUrl::List & urls )

Sets a list of urls associated to this application, they will be used as parameters for the associated application.

See also: setAssociatedApplication()

Parameters

urls

Definition at line 2234 of file applet.cpp.

void Plasma::Applet::setBackgroundHints ( const BackgroundHints hints )

Sets the BackgroundHints for this applet.

See also: BackgroundHint

Parameters

hints the BackgroundHint combination for this applet

Definition at line 938 of file applet.cpp.

void Plasma::Applet::setBusy ( bool busy )

slot

Shows a busy indicator that overlays the applet.

Parameters

busy	show or hide the busy indicator

Definition at line 791 of file applet.cpp.

void Plasma::Applet::setConfigurationRequired	(	bool	needsConfiguring,
		const QString &	reason = `QString()`
	)

protected

When the applet needs to be configured before being usable, this method can be called to show a standard interface prompting the user to configure the applet.

Parameters

needsConfiguring	true if the applet needs to be configured, or false if it doesn't
reason	a translated message for the user explaining that the applet needs configuring; this should note what needs to be configured

Definition at line 1010 of file applet.cpp.

void Plasma::Applet::setCustomCategories ( const QStringList & categories )

Sets the list of custom categories that are used in addition to the default set of categories known to libplasma for Applets.

Parameters

categories a list of categories

Since: 4.3

Definition at line 2394 of file applet.cpp.

void Plasma::Applet::setFailedToLaunch	(	bool	failed,
		const QString &	reason = `QString()`
	)

protected

Call this method when the applet fails to launch properly.

An optional reason can be provided.

Not that all children items will be deleted when this method is called. If you have pointers to these items, you will need to reset them after calling this method.

Parameters

failed	true when the applet failed, false when it succeeded
reason	an optional reason to show the user why the applet failed to launch

Definition at line 366 of file applet.cpp.

void Plasma::Applet::setGlobalShortcut ( const KShortcut & shortcut )

Sets the global shorcut to associate with this widget.

Definition at line 1556 of file applet.cpp.

void Plasma::Applet::setHasConfigurationInterface ( bool hasInterface )

protected

Sets whether or not this applet provides a user interface for configuring the applet.

It defaults to false, and if true is passed in you should also reimplement createConfigurationInterface()

Parameters

hasInterface whether or not there is a user interface available

Definition at line 1724 of file applet.cpp.

void Plasma::Applet::setImmutability ( const ImmutabilityType immutable )

slot

Sets the immutability type for this applet (not immutable, user immutable or system immutable)

Parameters

immutable the new immutability type of this applet

Definition at line 919 of file applet.cpp.

void Plasma::Applet::setStatus ( const ItemStatus stat )

slot

sets the status for this applet

Since: 4.4

Definition at line 1198 of file applet.cpp.

QPainterPath Plasma::Applet::shape ( ) const

protectedvirtual

Reimplemented from QGraphicsItem.

Reimplemented from QGraphicsWidget.

Definition at line 2500 of file applet.cpp.

bool Plasma::Applet::shouldConserveResources ( ) const

Whether the applet should conserve resources.

If true, try to avoid doing stuff which is computationally heavy. Try to conserve power and resources.

Returns: true if it should conserve resources, false if it does not.

void Plasma::Applet::showConfigurationInterface ( )

virtualslot

Lets the user interact with the plasmoid options.

Called when the user selects the configure entry from the context menu.

Unless there is good reason for overriding this method, Applet subclasses should actually override createConfigurationInterface instead. A good example of when this isn't plausible is when using a dialog prepared by another library, such as KPropertiesDialog from libkfile. You probably want to call showConfigurationInterface(QWidget*) with the custom widget you created to actually show your interface

Definition at line 1898 of file applet.cpp.

void Plasma::Applet::showConfigurationInterface ( QWidget * widget )

slot

Actually show your custom configuration interface Use this only if you reimplemented showConfigurationInterface()

Parameters

widget the widget representing your configuration interface

Since: 4.5

Definition at line 2007 of file applet.cpp.

void Plasma::Applet::showMessage	(	const QIcon &	icon,
		const QString &	message,
		const Plasma::MessageButtons	buttons
	)

protected

Shows a message as an overlay of the applet: the message has an icon, text and (optional) buttons.

Parameters

icon	the icon that will be shown
message	the message string that will be shown. If the message is empty nothng will be shown and if there was a message already it will be hidden
buttons	an OR combination of all the buttons needed

See also: Plasma::MessageButtons; messageButtonPressed

Since: 4.3

Definition at line 1062 of file applet.cpp.

QSizeF Plasma::Applet::sizeHint	(	Qt::SizeHint	which,
		const QSizeF &	constraint = `QSizeF()`
	)		const

protectedvirtual

Reimplemented from QGraphicsLayoutItem.

Reimplemented from QGraphicsWidget.

Reimplemented in Plasma::PopupApplet.

Definition at line 2509 of file applet.cpp.

void Plasma::Applet::sizeHintChanged ( Qt::SizeHint which )

signal

Emitted by Applet subclasses when they change a sizeHint and wants to announce the change.

QVariantList Plasma::Applet::startupArguments ( ) const

slot

Returns: the list of arguments which the applet was called with

Since: KDE4.3

Definition at line 1188 of file applet.cpp.

ItemStatus Plasma::Applet::status ( ) const

slot

Returns: the status of the applet

Since: 4.4

Definition at line 1193 of file applet.cpp.

void Plasma::Applet::timerEvent ( QTimerEvent * event )

protectedvirtual

Reimplemented from QObject.

Reimplemented in Plasma::PopupApplet.

Definition at line 2553 of file applet.cpp.

int Plasma::Applet::type ( ) const

virtual

Reimplemented from QGraphicsItem.

Reimplemented from QGraphicsWidget.

Definition at line 1379 of file applet.cpp.

void Plasma::Applet::unpublish ( )

slot

Definition at line 1700 of file applet.cpp.

void Plasma::Applet::unregisterAsDragHandle ( QGraphicsItem * item )

protected

Unregister a widget registered with registerAsDragHandle.

Parameters

item	the item to unregister

Definition at line 1657 of file applet.cpp.

void Plasma::Applet::updateConstraints ( Plasma::Constraints constraints = Plasma::AllConstraints )

Called when any of the geometry constraints have been updated.

This method calls constraintsEvent, which may be reimplemented, once the Applet has been prepared for updating the constraints.

Parameters

constraints the type of constraints that were updated

Definition at line 750 of file applet.cpp.

QGraphicsView * Plasma::Applet::view ( ) const

Returns the view this widget is visible on, or 0 if none can be found.

Warning: do NOT assume this will always return a view! a null view probably means that either plasma isn't finished loading, or your applet is on an activity that's not being shown anywhere.

Definition at line 696 of file applet.cpp.

Property Documentation

Applet::BackgroundHints Plasma::Applet::backgroundHints

readwrite

Definition at line 93 of file applet.h.

bool Plasma::Applet::busy

readwrite

Definition at line 87 of file applet.h.

QString Plasma::Applet::category

read

Definition at line 83 of file applet.h.

bool Plasma::Applet::configurationRequired

readwrite

Definition at line 88 of file applet.h.

QRectF Plasma::Applet::geometry

readwrite

Definition at line 89 of file applet.h.

bool Plasma::Applet::hasConfigurationInterface

read

Definition at line 80 of file applet.h.

bool Plasma::Applet::hasFailedToLaunch

readwrite

Definition at line 85 of file applet.h.

uint Plasma::Applet::id

read

Definition at line 91 of file applet.h.

ImmutabilityType Plasma::Applet::immutability

readwrite

Definition at line 84 of file applet.h.

bool Plasma::Applet::isBusy

readwrite

Definition at line 86 of file applet.h.

QString Plasma::Applet::name

read

Definition at line 81 of file applet.h.

QString Plasma::Applet::pluginName

read

Definition at line 82 of file applet.h.

bool Plasma::Applet::shouldConserveResources

read

Definition at line 90 of file applet.h.

bool Plasma::Applet::userConfiguring

read

Definition at line 92 of file applet.h.

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

Plasma

Public Types

Public Slots

Signals

Public Member Functions

Static Public Member Functions

Protected Member Functions

Properties

Additional Inherited Members

Detailed Description

Member Typedef Documentation

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Property Documentation

Plasma

kdelibs API Reference

Search