KSelectionWatcher

#include <kselectionwatcher.h>

Inheritance diagram for KSelectionWatcher:

Signals
void	lostOwner ()

void	newOwner (xcb_window_t owner)

Public Member Functions
	KSelectionWatcher (const char selection, int screen=-1, QObject parent=nullptr)

	KSelectionWatcher (const char selection, xcb_connection_t c, xcb_window_t root, QObject *parent=nullptr)

	KSelectionWatcher (xcb_atom_t selection, int screen=-1, QObject *parent=nullptr)

	KSelectionWatcher (xcb_atom_t selection, xcb_connection_t c, xcb_window_t root, QObject parent=nullptr)

void	filterEvent (void *ev_P)

xcb_window_t	owner ()

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

QBindable< QString >	bindableObjectName ()

bool	blockSignals (bool block)

const QObjectList &	children () const const

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

void	deleteLater ()

void	destroyed (QObject *obj)

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

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

void	dumpObjectInfo () const const

void	dumpObjectTree () const const

QList< QByteArray >	dynamicPropertyNames () const const

virtual bool	event (QEvent *e)

virtual bool	eventFilter (QObject watched, QEvent event)

T	findChild (const QString &name, Qt::FindChildOptions options) const const

QList< T >	findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const

QList< T >	findChildren (const QString &name, Qt::FindChildOptions options) const const

QList< T >	findChildren (Qt::FindChildOptions options) const const

bool	inherits (const char *className) const const

void	installEventFilter (QObject *filterObj)

bool	isQuickItemType () const const

bool	isWidgetType () const const

bool	isWindowType () const const

void	killTimer (int id)

virtual const QMetaObject *	metaObject () const const

void	moveToThread (QThread *targetThread)

QString	objectName () const const

void	objectNameChanged (const QString &objectName)

QObject *	parent () const const

QVariant	property (const char *name) const const

	Q_CLASSINFO (Name, Value)

	Q_EMIT Q_EMIT

	Q_ENUM (...)

	Q_ENUM_NS (...)

	Q_ENUMS (...)

	Q_FLAG (...)

	Q_FLAG_NS (...)

	Q_FLAGS (...)

	Q_GADGET Q_GADGET

	Q_GADGET_EXPORT (EXPORT_MACRO)

	Q_INTERFACES (...)

	Q_INVOKABLE Q_INVOKABLE

	Q_MOC_INCLUDE Q_MOC_INCLUDE

	Q_NAMESPACE Q_NAMESPACE

	Q_NAMESPACE_EXPORT (EXPORT_MACRO)

	Q_OBJECT Q_OBJECT

	Q_PROPERTY (...)

	Q_REVISION Q_REVISION

	Q_SET_OBJECT_NAME (Object)

	Q_SIGNAL Q_SIGNAL

	Q_SIGNALS Q_SIGNALS

	Q_SLOT Q_SLOT

	Q_SLOTS Q_SLOTS

T	qobject_cast (const QObject *object)

T	qobject_cast (QObject *object)

	QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT

void	removeEventFilter (QObject *obj)

void	setObjectName (const QString &name)

void	setObjectName (QAnyStringView name)

void	setParent (QObject *parent)

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

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

bool	signalsBlocked () const const

int	startTimer (int interval, Qt::TimerType timerType)

int	startTimer (std::chrono::milliseconds interval, Qt::TimerType timerType)

QThread *	thread () const const

Additional Inherited Members
Properties inherited from QObject
	objectName

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

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

QMetaObject::Connection	connect (const QObject sender, PointerToMemberFunction signal, const QObject context, Functor functor, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject sender, PointerToMemberFunction signal, const QObject receiver, PointerToMemberFunction method, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)

bool	disconnect (const QMetaObject::Connection &connection)

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)

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

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

Public Attributes inherited from QObject
typedef	QObjectList

Protected Member Functions inherited from QObject
virtual void	childEvent (QChildEvent *event)

virtual void	connectNotify (const QMetaMethod &signal)

virtual void	customEvent (QEvent *event)

virtual void	disconnectNotify (const QMetaMethod &signal)

bool	isSignalConnected (const QMetaMethod &signal) const const

int	receivers (const char *signal) const const

QObject *	sender () const const

int	senderSignalIndex () const const

virtual void	timerEvent (QTimerEvent *event)

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

This class is only useful on the xcb platform. On other platforms the code is only functional if the constructor overloads taking an xcb_connection_t are used. In case you inherit from this class ensure that you don't use xcb and/or XLib without verifying the platform.

Definition at line 28 of file kselectionwatcher.h.

Constructor & Destructor Documentation

◆ KSelectionWatcher() [1/4]

KSelectionWatcher::KSelectionWatcher	(	xcb_atom_t	selection,
		int	screen = -1,
		QObject *	parent = nullptr )

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 nullptr if there is none

Definition at line 111 of file kselectionwatcher.cpp.

◆ KSelectionWatcher() [2/4]

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

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 nullptr if there is none

Definition at line 118 of file kselectionwatcher.cpp.

◆ KSelectionWatcher() [3/4]

KSelectionWatcher::KSelectionWatcher	(	xcb_atom_t	selection,
		xcb_connection_t *	c,
		xcb_window_t	root,
		QObject *	parent = nullptr )

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 xcb_connection_t and root window and doesn't depend on running on the xcb platform.

Otherwise this constructor behaves like the similar one without the xcb_connection_t.

Parameters

selection	atom representing the manager selection
c	the xcb connection this KSelectionWatcher should use
root	the root window this KSelectionWatcher should use

Since: 5.8

Definition at line 125 of file kselectionwatcher.cpp.

◆ KSelectionWatcher() [4/4]

KSelectionWatcher::KSelectionWatcher	(	const char *	selection,
		xcb_connection_t *	c,
		xcb_window_t	root,
		QObject *	parent = nullptr )

explicit

Otherwise this constructor behaves like the similar one without the xcb_connection_t.

Parameters

selection	name of the manager selection
c	the xcb connection this KSelectionWatcher should use
root	the root window this KSelectionWatcher should use

Since: 5.8

Definition at line 132 of file kselectionwatcher.cpp.

◆ ~KSelectionWatcher()

KSelectionWatcher::~KSelectionWatcher ( )

override

Definition at line 139 of file kselectionwatcher.cpp.

Member Function Documentation

◆ filterEvent()

void KSelectionWatcher::filterEvent ( void * ev_P )

Definition at line 212 of file kselectionwatcher.cpp.

◆ lostOwner

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 immediately 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.

◆ newOwner

void KSelectionWatcher::newOwner ( xcb_window_t owner )

signal

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

Parameters

owner the new owner of the selection

◆ owner()

xcb_window_t 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 173 of file kselectionwatcher.cpp.

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

KDE's Doxygen guidelines are available online.

Class Picker

Quick Links

About KWindowSystem

KSelectionWatcher

Signals

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ KSelectionWatcher() [1/4]

◆ KSelectionWatcher() [2/4]

◆ KSelectionWatcher() [3/4]

◆ KSelectionWatcher() [4/4]

◆ ~KSelectionWatcher()

Member Function Documentation

◆ filterEvent()

◆ lostOwner

◆ newOwner

◆ owner()