KSelectionWatcher Class Reference

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

#include <kmanagerselection.h>

Inheritance diagram for KSelectionWatcher:

List of all members.

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 ()

---

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