Plasma::Dialog Class Reference

#include <Plasma/Dialog>

Inheritance diagram for Plasma::Dialog:

Public Types
enum	ResizeCorner {   NoCorner = 0, NorthEast = 1, SouthEast = 2, NorthWest = 4,   SouthWest = 8, All = NorthEast | SouthEast | NorthWest | SouthWest }

Public Slots
void	syncToGraphicsWidget ()

Signals
void	dialogResized ()
void	dialogVisible (bool status)

Public Member Functions
	Dialog (QWidget *parent=0, Qt::WindowFlags f=Qt::Window)
virtual	~Dialog ()
void	animatedHide (Plasma::Direction direction)
void	animatedShow (Plasma::Direction direction)
Plasma::AspectRatioMode	aspectRatioMode () const
void	getMinimumResizeLimits (int *left, int *top, int *right, int *bottom)
QGraphicsWidget *	graphicsWidget ()
bool	isUserResizing () const
ResizeCorners	resizeCorners () const
void	setAspectRatioMode (Plasma::AspectRatioMode mode)
void	setGraphicsWidget (QGraphicsWidget *widget)
void	setMinimumResizeLimits (int left, int top, int right, int bottom)
void	setResizeHandleCorners (ResizeCorners corners)

Protected Member Functions
bool	event (QEvent *event)
bool	eventFilter (QObject *watched, QEvent *event)
void	focusInEvent (QFocusEvent *event)
void	hideEvent (QHideEvent *event)
bool	inControlArea (const QPoint &point)
void	keyPressEvent (QKeyEvent *event)
void	mouseMoveEvent (QMouseEvent *event)
void	mousePressEvent (QMouseEvent *event)
void	mouseReleaseEvent (QMouseEvent *event)
void	moveEvent (QMoveEvent *event)
void	paintEvent (QPaintEvent *e)
void	resizeEvent (QResizeEvent *e)
void	showEvent (QShowEvent *event)

Detailed Description

A dialog that uses the Plasma style.

Dialog provides a dialog-like widget that can be used to display additional information.

Dialog uses the plasma theme, and usually has no window decoration. It's meant as an interim solution to display widgets as extension to plasma applets, for example when you click on an applet like the devicenotifier or the clock, the widget that is then displayed, is a Dialog.

Definition at line 51 of file dialog.h.

Member Enumeration Documentation

enum Plasma::Dialog::ResizeCorner

Use these flags to choose the active resize corners.

Enumerator:

NoCorner
NorthEast
SouthEast
NorthWest
SouthWest
All

Definition at line 58 of file dialog.h.

Constructor & Destructor Documentation

Plasma::Dialog::Dialog ( QWidget *  parent = 0, Qt::WindowFlags  f = Qt::Window  )

explicit

Parameters

parent	the parent widget, for plasmoids, this is usually 0.
f	the Qt::WindowFlags, default is to not show a windowborder.

Definition at line 385 of file dialog.cpp.

Plasma::Dialog::~Dialog ( )

virtual

Definition at line 413 of file dialog.cpp.

Member Function Documentation

void Plasma::Dialog::animatedHide

(

Plasma::Direction

direction

)

Causes an animated hide; requires compositing to work, otherwise the dialog will simply hide.

Since

4.3

Definition at line 798 of file dialog.cpp.

void Plasma::Dialog::animatedShow

(

Plasma::Direction

direction

)

Causes an animated show; requires compositing to work, otherwise the dialog will simply show.

Since

4.3

Definition at line 831 of file dialog.cpp.

Plasma::AspectRatioMode Plasma::Dialog::aspectRatioMode

(

)

const

Returns

the preferred aspect ratio mode for placement and resizing

Since

4.4

Definition at line 874 of file dialog.cpp.

void Plasma::Dialog::dialogResized ( )

signal

Fires when the dialog automatically resizes.

void Plasma::Dialog::dialogVisible ( bool  status )

signal

Emit a signal when the dialog become visible/invisible.

bool Plasma::Dialog::event ( QEvent *  event )

protected

Definition at line 554 of file dialog.cpp.

bool Plasma::Dialog::eventFilter ( QObject *  watched, QEvent *  event  )

protected

Definition at line 676 of file dialog.cpp.

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

protected

Definition at line 732 of file dialog.cpp.

void Plasma::Dialog::getMinimumResizeLimits	(	int *	left,
		int *	top,
		int *	right,
		int *	bottom
	)

Retrives the minimum resize limits for the dialog.

Parameters

left	the screen coordinate that the left may not go beyond; -1 for no limit
top	the screen coordinate that the top may not go beyond; -1 for no limit
right	the screen coordinate that the right may not go beyond; -1 for no limit
bottom	the screen coordinate that the bottom may not go beyond; -1 for no limit

Definition at line 779 of file dialog.cpp.

QGraphicsWidget * Plasma::Dialog::graphicsWidget

(

)

Returns

the graphics widget shown in this dialog

Definition at line 671 of file dialog.cpp.

void Plasma::Dialog::hideEvent ( QHideEvent *  event )

protected

Definition at line 695 of file dialog.cpp.

bool Plasma::Dialog::inControlArea ( const QPoint &  point )

protected

Convenience method to know whether the point is in a control area (e.g.

resize area) or not.

Returns

true if the point is in the control area.

Definition at line 864 of file dialog.cpp.

bool Plasma::Dialog::isUserResizing

(

)

const

Returns

true if currently being resized by the user

Definition at line 766 of file dialog.cpp.

void Plasma::Dialog::keyPressEvent ( QKeyEvent *  event )

protected

Definition at line 547 of file dialog.cpp.

void Plasma::Dialog::mouseMoveEvent ( QMouseEvent *  event )

protected

Definition at line 425 of file dialog.cpp.

void Plasma::Dialog::mousePressEvent ( QMouseEvent *  event )

protected

Definition at line 519 of file dialog.cpp.

void Plasma::Dialog::mouseReleaseEvent ( QMouseEvent *  event )

protected

Definition at line 536 of file dialog.cpp.

void Plasma::Dialog::moveEvent ( QMoveEvent *  event )

protected

Definition at line 746 of file dialog.cpp.

void Plasma::Dialog::paintEvent ( QPaintEvent *  e )

protected

Reimplemented from QWidget.

Definition at line 418 of file dialog.cpp.

Dialog::ResizeCorners Plasma::Dialog::resizeCorners

(

)

const

Convenience method to get the enabled resize corners.

Returns

which resize corners are active.

Definition at line 761 of file dialog.cpp.

void Plasma::Dialog::resizeEvent ( QResizeEvent *  e )

protected

Definition at line 559 of file dialog.cpp.

void Plasma::Dialog::setAspectRatioMode

(

Plasma::AspectRatioMode

mode

)

Sets the preferred aspect ratio mode for placement and resizing.

Since

4.4

Definition at line 879 of file dialog.cpp.

void Plasma::Dialog::setGraphicsWidget

(

QGraphicsWidget *

widget

)

Sets a QGraphicsWidget to be shown as the content in this dialog.

The dialog will then set up a QGraphicsView and coordinate geometry with the widget automatically.

Parameters

widget

the QGraphicsWidget to display in this dialog

Definition at line 617 of file dialog.cpp.

void Plasma::Dialog::setMinimumResizeLimits	(	int	left,
		int	top,
		int	right,
		int	bottom
	)

Sets the minimum values that each of four sides of the rect may expand to or from.

Parameters

left	the screen coordinate that the left may not go beyond; -1 for no limit
top	the screen coordinate that the top may not go beyond; -1 for no limit
right	the screen coordinate that the right may not go beyond; -1 for no limit
bottom	the screen coordinate that the bottom may not go beyond; -1 for no limit

Definition at line 771 of file dialog.cpp.

void Plasma::Dialog::setResizeHandleCorners

(

ResizeCorners

corners

)

Parameters

corners

the corners the resize handlers should be placed in.

Definition at line 753 of file dialog.cpp.

void Plasma::Dialog::showEvent ( QShowEvent *  event )

protected

Definition at line 701 of file dialog.cpp.

void Plasma::Dialog::syncToGraphicsWidget ( )

slot

Adjusts the dialog to the associated QGraphicsWidget's geometry Should not normally need to be called by users of Dialog as Dialog does it automatically.

Event compression may cause unwanted delays, however, and so this method may be called to immediately cause a synchronization.

Since

4.5

Definition at line 287 of file dialog.cpp.

---

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

• dialog.h
• dialog.cpp