15.1.378. tablet_qt/qobjects/debugeventwatcher.h

/*
    Copyright (C) 2012, University of Cambridge, Department of Psychiatry.
    Created by Rudolf Cardinal (rnc1001@cam.ac.uk).

    This file is part of CamCOPS.

    CamCOPS is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    CamCOPS is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with CamCOPS. If not, see <https://www.gnu.org/licenses/>.
*/

#pragma once
#include <QObject>

class QEvent;

// Object to watch, and debug-log, all mouse/touch events on a QObject.
// Create with simply:
//      new DebugEventWatcher(this, DebugEventWatcher::All);

class DebugEventWatcher : public QObject
{
    Q_OBJECT

public:
    // Categories of event to watch.
    enum EventCategory {  // https://doc.qt.io/qt-6.5/qflags.html#details
        All = (1 << 0),
        MouseTouch = (1 << 1),
    };
    Q_DECLARE_FLAGS(EventCategories, EventCategory)

public:
    // Constructor
    explicit DebugEventWatcher(QObject* parent, EventCategories categories);

    // Receive incoming events.
    virtual bool eventFilter(QObject* obj, QEvent* event) override;

private:
    // Describe the events to the debug stream.
    void report(QObject* obj, QEvent* event) const;

private:
    EventCategories m_categories;
};

Q_DECLARE_OPERATORS_FOR_FLAGS(DebugEventWatcher::EventCategories)