KSelectionWatcher Class Reference

#include <kmanagerselection.h>

Inheritance diagram for KSelectionWatcher:

Signals
void	lostOwner ()
void	newOwner (Window owner)

Public Member Functions
	KSelectionWatcher (Atom selection, int screen=-1, QObject *parent=NULL)
	KSelectionWatcher (const char *selection, int screen=-1, QObject *parent=NULL)
virtual	~KSelectionWatcher ()
void	filterEvent (XEvent *ev_P)
Window	owner ()
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
virtual bool	event (QEvent *e)
virtual bool	eventFilter (QObject *watched, QEvent *event)
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

Additional Inherited Members
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 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
virtual void	timerEvent (QTimerEvent *event)
Static Protected Member Functions inherited from QObject
QByteArray	normalizeSignalSlot (const char *signalSlot)
Properties inherited from QObject
	objectName

Detailed Description

This class implements watching manager selections, as described in the ICCCM section 2.8.

It emits signal newOwner() when a new owner claim the selection, and emits lostOwner() when the selection ownership is given up. To find out current owner of the selection, owner() can be used. ICCCM manager selection watching

Definition at line 155 of file kmanagerselection.h.

Constructor & Destructor Documentation

KSelectionWatcher::KSelectionWatcher ( Atom  selection, int  screen = -1, QObject *  parent = NULL  )

explicit

This constructor initializes the object, but doesn't perform any operation on the selection.

Parameters

selection	atom representing the manager selection
screen	X screen, or -1 for default
parent	parent object, or NULL if there is none

Definition at line 403 of file kmanagerselection.cpp.

KSelectionWatcher::KSelectionWatcher ( const char *  selection, int  screen = -1, QObject *  parent = NULL  )

explicit

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This constructor accepts the selection name and creates the appropriate atom for it automatically.

Parameters

selection	name of the manager selection
screen	X screen, or -1 for default
parent	parent object, or NULL if there is none

Definition at line 410 of file kmanagerselection.cpp.

KSelectionWatcher::~KSelectionWatcher ( )

virtual

Definition at line 417 of file kmanagerselection.cpp.

Member Function Documentation

void KSelectionWatcher::filterEvent

(

XEvent *

ev_P

)

Definition at line 459 of file kmanagerselection.cpp.

void KSelectionWatcher::lostOwner ( )

signal

This signal is emitted when the selection is given up, i.e.

there's no owner. Note that the selection may be immediatelly claimed again, so the newOwner() signal may be emitted right after this one. It's safe to delete the instance in a slot connected to this signal.

void KSelectionWatcher::newOwner ( Window  owner )

signal

This signal is emitted when the selection is successfully claimed by a new owner.

Parameters

owner

the new owner of the selection

Window KSelectionWatcher::owner

(

)

Return the current owner of the manager selection, if any.

Note that if the event informing about the owner change is still in the input queue, newOwner() might have been emitted yet.

Definition at line 437 of file kmanagerselection.cpp.

---

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

• kmanagerselection.h
• kmanagerselection.cpp