Allows applets to automatically 'collapse' into an icon when put in an panel, and is a convenient base class for any applet that wishes to use extenders. More...

#include <popupapplet.h>

Inheritance diagram for Plasma::PopupApplet:

[legend]

List of all members.

Public Slots
void	hidePopup ()
void	showPopup (uint displayTime=0)
void	togglePopup ()
Public Member Functions
	PopupApplet (QObject *parent, const QVariantList &args)
	~PopupApplet ()
virtual QGraphicsWidget *	graphicsWidget ()
bool	isIconified () const
bool	isPassivePopup () const
bool	isPopupShowing () const
Qt::AlignmentFlag	popupAlignment () const
QIcon	popupIcon () const
Plasma::PopupPlacement	popupPlacement () const
void	setGraphicsWidget (QGraphicsWidget *widget)
void	setPassivePopup (bool passive)
void	setPopupAlignment (Qt::AlignmentFlag alignment)
void	setPopupIcon (const QString &iconName)
void	setPopupIcon (const QIcon &icon)
void	setWidget (QWidget *widget)
virtual QWidget *	widget ()
Protected Member Functions
void	dragEnterEvent (QGraphicsSceneDragDropEvent *event)
void	dragLeaveEvent (QGraphicsSceneDragDropEvent *event)
void	dropEvent (QGraphicsSceneDragDropEvent *event)
bool	eventFilter (QObject watched, QEvent event)
void	mousePressEvent (QGraphicsSceneMouseEvent *event)
void	mouseReleaseEvent (QGraphicsSceneMouseEvent *event)
virtual void	popupEvent (bool show)
QSizeF	sizeHint (Qt::SizeHint which, const QSizeF &constraint=QSizeF()) const
void	timerEvent (QTimerEvent *event)
Properties
Qt::AlignmentFlag	popupAlignment

Detailed Description

Allows applets to automatically 'collapse' into an icon when put in an panel, and is a convenient base class for any applet that wishes to use extenders.

Applets that subclass this class should implement either widget() or graphicsWidget() to return a widget that will be displayed in the applet if the applet is in a Planar or MediaCenter form factor. If the applet is put in a panel, an icon will be displayed instead, which shows the widget in a popup when clicked.

If you use this class as a base class for your extender using applet, the extender will automatically be used for the popup; reimplementing graphicsWidget() is unnecessary in this case. If you need a popup that does not steal window focus when openend or used, set window flag Qt::X11BypassWindowManagerHint the widget returned by widget() or graphicsWidget().

Definition at line 52 of file popupapplet.h.

Constructor & Destructor Documentation

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

Definition at line 58 of file popupapplet.cpp.

Plasma::PopupApplet::~PopupApplet ( )

Definition at line 70 of file popupapplet.cpp.

Member Function Documentation

void Plasma::PopupApplet::dragEnterEvent ( QGraphicsSceneDragDropEvent * event ) [protected]

Reimplemented from QGraphicsLayoutItem.

Definition at line 527 of file popupapplet.cpp.

void Plasma::PopupApplet::dragLeaveEvent ( QGraphicsSceneDragDropEvent * event ) [protected]

Reimplemented from QGraphicsLayoutItem.

Definition at line 539 of file popupapplet.cpp.

void Plasma::PopupApplet::dropEvent ( QGraphicsSceneDragDropEvent * event ) [protected]

Reimplemented from QGraphicsLayoutItem.

Definition at line 558 of file popupapplet.cpp.

bool Plasma::PopupApplet::eventFilter	(	QObject *	watched,
		QEvent *	event
	)		`[protected]`

Reimplemented from QGraphicsLayoutItem.

Reimplemented from Plasma::Applet.

Definition at line 485 of file popupapplet.cpp.

QGraphicsWidget * Plasma::PopupApplet::graphicsWidget ( ) [virtual]

Implement either this function or widget().

Returns:: the widget that will get shown in either a layout, in the applet or in a Dialog, depending on the form factor of the applet. If you set a popup icon you must also set a minimum size of the applet. When the applet is smaller than this minimum size, it will be displayed as that icon.

Definition at line 184 of file popupapplet.cpp.

void Plasma::PopupApplet::hidePopup ( ) [slot]

Hides the popup.

Definition at line 613 of file popupapplet.cpp.

bool Plasma::PopupApplet::isIconified ( ) const

Returns:: true if the applet is collapsed to an icon

Since:: 4.6

Definition at line 669 of file popupapplet.cpp.

bool Plasma::PopupApplet::isPassivePopup ( ) const

Returns:: true if the dialog will be treated as a passive poup

Definition at line 659 of file popupapplet.cpp.

bool Plasma::PopupApplet::isPopupShowing ( ) const [virtual]

Returns:: true if the applet is popped up

Reimplemented from Plasma::Applet.

Definition at line 664 of file popupapplet.cpp.

void Plasma::PopupApplet::mousePressEvent ( QGraphicsSceneMouseEvent * event ) [protected]

Reimplemented from QGraphicsLayoutItem.

Definition at line 463 of file popupapplet.cpp.

void Plasma::PopupApplet::mouseReleaseEvent ( QGraphicsSceneMouseEvent * event ) [protected]

Reimplemented from QGraphicsLayoutItem.

Definition at line 475 of file popupapplet.cpp.

Qt::AlignmentFlag Plasma::PopupApplet::popupAlignment ( ) const

Returns:: the default alignment of the popup relative to the applet

Since:: 4.6

void Plasma::PopupApplet::popupEvent ( bool show ) [protected, virtual]

This event handler can be reimplemented in a subclass to receive an event before the popup is shown or hidden.

show true if the popup is going to be shown, false if the popup is going to be hidden. Note that showing and hiding the popup on click is already done in PopupApplet.

Definition at line 647 of file popupapplet.cpp.

QIcon Plasma::PopupApplet::popupIcon ( ) const

Returns:: the icon that is displayed when the applet is in a panel.

Definition at line 143 of file popupapplet.cpp.

Plasma::PopupPlacement Plasma::PopupApplet::popupPlacement ( ) const

Returns:: the placement of the popup relating to the applet

Definition at line 632 of file popupapplet.cpp.

void Plasma::PopupApplet::setGraphicsWidget ( QGraphicsWidget * widget )

Definition at line 193 of file popupapplet.cpp.

void Plasma::PopupApplet::setPassivePopup ( bool passive )

Sets whether or not the dialog popup that gets created should be a "passive" popup that does not steal focus from other windows or not.

passive true if the dialog should be treated as a passive popup

Definition at line 654 of file popupapplet.cpp.

void Plasma::PopupApplet::setPopupAlignment ( Qt::AlignmentFlag alignment )

Sets the default alignment of the popup relative to the applet.

alignment the alignment to use; Qt::AlignLeft or Qt::AlignRight
Since:
4.6

Definition at line 637 of file popupapplet.cpp.

void Plasma::PopupApplet::setPopupIcon ( const QString & iconName )

icon the icon that has to be displayed when the applet is in a panel. Passing in an empty QString() means that the popup applet itself will provide an interface for when the PopupApplet is not showing the widget() or graphicsWidget() directly.

If you set a popup icon you must also set a minimum size of the applet. When the applet is smaller than this minimum size, it will be displayed as that icon.

Definition at line 104 of file popupapplet.cpp.

void Plasma::PopupApplet::setPopupIcon ( const QIcon & icon )

icon the icon that has to be displayed when the applet is in a panel. Passing in a null icon means that the popup applet itself will provide an interface for when the PopupApplet is not showing the widget() or graphicsWidget() directly.

Definition at line 76 of file popupapplet.cpp.

void Plasma::PopupApplet::setWidget ( QWidget * widget )

Definition at line 153 of file popupapplet.cpp.

void Plasma::PopupApplet::showPopup ( uint displayTime = 0 ) [slot]

Shows the dialog showing the widget if the applet is in a panel.

displayTime the time in ms that the popup should be displayed, defaults to 0 which means always (until the user closes it again, that is).

Definition at line 570 of file popupapplet.cpp.

QSizeF Plasma::PopupApplet::sizeHint	(	Qt::SizeHint	which,
		const QSizeF &	constraint = `QSizeF()`
	)		const `[protected]`

Reimplemented from QGraphicsLayoutItem.

Reimplemented from Plasma::Applet.

Definition at line 442 of file popupapplet.cpp.

void Plasma::PopupApplet::timerEvent ( QTimerEvent * event ) [protected]

Reimplemented from QGraphicsLayoutItem.

Reimplemented from Plasma::Applet.

Definition at line 588 of file popupapplet.cpp.

void Plasma::PopupApplet::togglePopup ( ) [slot]

Toggles the popup.

Definition at line 627 of file popupapplet.cpp.

QWidget * Plasma::PopupApplet::widget ( ) [virtual]

Implement either this function or graphicsWidget().

Returns:: the widget that will get shown in either a layout, in the applet or in a Dialog, depending on the form factor of the applet.

Definition at line 148 of file popupapplet.cpp.

Property Documentation

Qt::AlignmentFlag Plasma::PopupApplet::popupAlignment [read, write]

Definition at line 55 of file popupapplet.h.

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

Plasma

Plasma::PopupApplet Class Reference

Public Slots

Public Member Functions

Protected Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Property Documentation

Plasma

kdelibs