KSelectionWatcher

KSelectionWatcher Class Reference

#include <kselectionwatcher.h>

Inheritance diagram for KSelectionWatcher:

Signals

void lostOwner ()
 
void newOwner (xcb_window_t owner)
 

Public Member Functions

 KSelectionWatcher (xcb_atom_t selection, int screen=-1, QObject *parent=nullptr)
 
 KSelectionWatcher (const char *selection, int screen=-1, QObject *parent=nullptr)
 
 KSelectionWatcher (xcb_atom_t selection, xcb_connection_t *c, xcb_window_t root, QObject *parent=nullptr)
 
 KSelectionWatcher (const char *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)
 
bool blockSignals (bool block)
 
const QObjectListchildren () 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 ()
 
void dumpObjectInfo () const const
 
void dumpObjectTree ()
 
void dumpObjectTree () const const
 
QList< QByteArraydynamicPropertyNames () const const
 
virtual bool event (QEvent *e)
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 
findChild (const QString &name, Qt::FindChildOptions options) const const
 
QList< T > findChildren (const QString &name, Qt::FindChildOptions options) const const
 
QList< T > findChildren (const QRegExp &regExp, Qt::FindChildOptions options) const const
 
QList< T > findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const
 
bool inherits (const char *className) const const
 
void installEventFilter (QObject *filterObj)
 
bool isWidgetType () const const
 
bool isWindowType () const const
 
void killTimer (int id)
 
virtual const QMetaObjectmetaObject () const const
 
void moveToThread (QThread *targetThread)
 
QString objectName () const const
 
void objectNameChanged (const QString &objectName)
 
QObjectparent () const const
 
QVariant property (const char *name) const const
 
 Q_CLASSINFO (Name, Value)
 
 Q_DISABLE_COPY (Class)
 
 Q_DISABLE_COPY_MOVE (Class)
 
 Q_DISABLE_MOVE (Class)
 
 Q_EMIT Q_EMIT
 
 Q_ENUM (...)
 
 Q_ENUM_NS (...)
 
 Q_ENUMS (...)
 
 Q_FLAG (...)
 
 Q_FLAG_NS (...)
 
 Q_FLAGS (...)
 
 Q_GADGET Q_GADGET
 
 Q_INTERFACES (...)
 
 Q_INVOKABLE Q_INVOKABLE
 
 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
 
qFindChild (const QObject *obj, const QString &name)
 
QList< T > qFindChildren (const QObject *obj, const QRegExp &regExp)
 
QList< T > qFindChildren (const QObject *obj, const QString &name)
 
qobject_cast (QObject *object)
 
qobject_cast (const QObject *object)
 
 QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT
 
void removeEventFilter (QObject *obj)
 
void setObjectName (const QString &name)
 
void setParent (QObject *parent)
 
bool setProperty (const char *name, const QVariant &value)
 
bool signalsBlocked () const const
 
int startTimer (int interval, Qt::TimerType timerType)
 
int startTimer (std::chrono::milliseconds time, Qt::TimerType timerType)
 
QThreadthread () 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 *receiver, PointerToMemberFunction method, Qt::ConnectionType type)
 
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)
 
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type)
 
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, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction 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)
 
- 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
 
QObjectsender () 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::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
selectionatom representing the manager selection
screenX screen, or -1 for default
parentparent object, or nullptr if there is none

Definition at line 113 of file kselectionwatcher.cpp.

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
selectionname of the manager selection
screenX screen, or -1 for default
parentparent object, or nullptr if there is none

Definition at line 120 of file kselectionwatcher.cpp.

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
selectionatom representing the manager selection
cthe xcb connection this KSelectionWatcher should use
rootthe root window this KSelectionWatcher should use
Since
5.8

Definition at line 127 of file kselectionwatcher.cpp.

KSelectionWatcher::KSelectionWatcher ( const char *  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
selectionname of the manager selection
cthe xcb connection this KSelectionWatcher should use
rootthe root window this KSelectionWatcher should use
Since
5.8

Definition at line 134 of file kselectionwatcher.cpp.

Member Function Documentation

void KSelectionWatcher::filterEvent ( void *  ev_P)

Definition at line 214 of file kselectionwatcher.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 ( xcb_window_t  owner)
signal

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

Parameters
ownerthe new owner of the selection
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 175 of file kselectionwatcher.cpp.


The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2020 The KDE developers.
Generated on Thu Nov 26 2020 22:39:23 by doxygen 1.8.11 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.