File indexing completed on 2025-03-16 11:21:58

 /*
     KWin - the KDE window manager
     This file is part of the KDE project.
 
     SPDX-FileCopyrightText: 2019 Roman Gilg <subdiff@gmail.com>
 
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 #pragma once
 
 #include <QObject>
 #include <QVector>
 
 #include <xcb/xcb.h>
 
 struct xcb_xfixes_selection_notify_event_t;
 
 class QTimer;
 
 namespace KWin
 {
 namespace Xwl
 {
 class TransferWltoX;
 class TransferXtoWl;
 class WlSource;
 class X11Source;
 
 /**
  * Base class representing generic X selections and their respective
  * Wayland counter-parts.
  *
  * The class needs to be subclassed and adjusted according to the
  * selection, but provides common fucntionality to be expected of all
  * selections.
  *
  * A selection should exist through the whole runtime of an Xwayland
  * session.
  *
  * Independently of each other the class holds the currently active
  * source instance and active transfers relative to the represented
  * selection.
  */
 class Selection : public QObject
 {
     Q_OBJECT
 
 public:
     static xcb_atom_t mimeTypeToAtom(const QString &mimeType);
     static xcb_atom_t mimeTypeToAtomLiteral(const QString &mimeType);
     static QStringList atomToMimeTypes(xcb_atom_t atom);
     static QString atomName(xcb_atom_t atom);
     static void sendSelectionNotify(xcb_selection_request_event_t *event, bool success);
 
     // on selection owner changes by X clients (Xwl -> Wl)
     bool handleXfixesNotify(xcb_xfixes_selection_notify_event_t *event);
     bool filterEvent(xcb_generic_event_t *event);
 
     xcb_atom_t atom() const
     {
         return m_atom;
     }
     xcb_window_t window() const
     {
         return m_window;
     }
     void overwriteRequestorWindow(xcb_window_t window);
 
 Q_SIGNALS:
     void transferFinished(xcb_timestamp_t eventTime);
 
 protected:
     Selection(xcb_atom_t atom, QObject *parent);
     void registerXfixes();
 
     virtual void doHandleXfixesNotify(xcb_xfixes_selection_notify_event_t *event) = 0;
     virtual void x11OffersChanged(const QStringList &added, const QStringList &removed) = 0;
 
     virtual bool handleClientMessage(xcb_client_message_event_t *event)
     {
         return false;
     }
     // sets the current provider of the selection
     void setWlSource(WlSource *source);
     WlSource *wlSource() const
     {
         return m_waylandSource;
     }
     void createX11Source(xcb_xfixes_selection_notify_event_t *event);
     X11Source *x11Source() const
     {
         return m_xSource;
     }
     // must be called in order to provide data from Wl to X
     void ownSelection(bool own);
     void setWindow(xcb_window_t window)
     {
         m_window = window;
     }
 
 private:
     bool handleSelectionRequest(xcb_selection_request_event_t *event);
     bool handleSelectionNotify(xcb_selection_notify_event_t *event);
     bool handlePropertyNotify(xcb_property_notify_event_t *event);
 
     void startTransferToWayland(xcb_atom_t target, qint32 fd);
     void startTransferToX(xcb_selection_request_event_t *event, qint32 fd);
 
     // Timeout transfers, which have become inactive due to client errors.
     void timeoutTransfers();
     void startTimeoutTransfersTimer();
     void endTimeoutTransfersTimer();
 
     xcb_atom_t m_atom = XCB_ATOM_NONE;
     xcb_window_t m_window = XCB_WINDOW_NONE;
     xcb_window_t m_requestorWindow = XCB_WINDOW_NONE;
     xcb_timestamp_t m_timestamp;
 
     // Active source, if any. Only one of them at max can exist
     // at the same time.
     WlSource *m_waylandSource = nullptr;
     X11Source *m_xSource = nullptr;
 
     // active transfers
     QVector<TransferWltoX *> m_wlToXTransfers;
     QVector<TransferXtoWl *> m_xToWlTransfers;
     QTimer *m_timeoutTransfers = nullptr;
 
     bool m_disownPending = false;
 
     Q_DISABLE_COPY(Selection)
 };
 
 } // namespace Xwl
 } // namespace KWin