qwt_event_pattern.h

/******************************************************************************
 * Qwt Widget Library
 * Copyright (C) 1997   Josef Wilgen
 * Copyright (C) 2002   Uwe Rathmann
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the Qwt License, Version 1.0
 *
 * Modified by ChenZongYan in 2024 <czy.t@163.com>
 *   Summary of major modifications (see ChangeLog.md for full history):
 *   1. CMake build system & C++11 throughout.
 *   2. Core panner/ zoomer refactored:
 *        - QwtPanner -> QwtCachePanner (pixmap-cache version)
 *        - New real-time QwtPlotPanner derived from QwtPicker.
 *   3. Zoomer supports multi-axis.
 *   4. Parasite-plot framework:
 *        - QwtFigure, QwtPlotParasiteLayout, QwtPlotTransparentCanvas,
 *        - QwtPlotScaleEventDispatcher, built-in pan/zoom on axis.
 *   5. New picker: QwtPlotSeriesDataPicker (works with date axis).
 *   6. Raster & color-map extensions:
 *        - QwtGridRasterData (2-D table + interpolation)
 *        - QwtLinearColorMap::stopColors(), stopPos() API rename.
 *   7. Bar-chart: expose pen/brush control.
 *   8. Amalgamated build: single QwtPlot.h / QwtPlot.cpp pair in src-amalgamate.
 *****************************************************************************/
 
#ifndef QWT_EVENT_PATTERN
#define QWT_EVENT_PATTERN
 
#include "qwt_global.h"
 
#include <qnamespace.h>
#include <qvector.h>
 
class QMouseEvent;
class QKeyEvent;
 
class QWT_EXPORT QwtEventPattern
{
public:
    enum MousePatternCode
    {
        MouseSelect1,
 
        MouseSelect2,
 
        MouseSelect3,
 
        MouseSelect4,
 
        MouseSelect5,
 
        MouseSelect6,
 
        MousePatternCount
    };
 
    enum KeyPatternCode
    {
        KeySelect1,
 
        KeySelect2,
 
        KeyAbort,
 
        KeyLeft,
 
        KeyRight,
 
        KeyUp,
 
        KeyDown,
 
        KeyRedo,
 
        KeyUndo,
 
        KeyHome,
 
        KeyPatternCount
    };
 
    class MousePattern
    {
    public:
        MousePattern(Qt::MouseButton btn = Qt::NoButton, Qt::KeyboardModifiers modifierCodes = Qt::NoModifier)
            : button(btn), modifiers(modifierCodes)
        {
        }
 
        Qt::MouseButton button;
 
        Qt::KeyboardModifiers modifiers;
    };
 
    class KeyPattern
    {
    public:
        KeyPattern(int keyCode = Qt::Key_unknown, Qt::KeyboardModifiers modifierCodes = Qt::NoModifier)
            : key(keyCode), modifiers(modifierCodes)
        {
        }
 
        int key;
 
        Qt::KeyboardModifiers modifiers;
    };
 
    // Constructor
    QwtEventPattern();
    // Destructor
    virtual ~QwtEventPattern();
 
    // Initialize mouse patterns depending on number of mouse buttons
    void initMousePattern(int numButtons);
    // Initialize key patterns with default settings
    void initKeyPattern();
 
    // Set a single mouse pattern by code
    void setMousePattern(MousePatternCode, Qt::MouseButton button, Qt::KeyboardModifiers = Qt::NoModifier);
 
    // Set a single key pattern by code
    void setKeyPattern(KeyPatternCode, int key, Qt::KeyboardModifiers modifiers = Qt::NoModifier);
 
    // Set all mouse patterns
    void setMousePattern(const QVector< MousePattern >&);
    // Set all key patterns
    void setKeyPattern(const QVector< KeyPattern >&);
 
    // Return the mouse pattern vector (const)
    const QVector< MousePattern >& mousePattern() const;
    // Return the key pattern vector (const)
    const QVector< KeyPattern >& keyPattern() const;
 
    // Return the mouse pattern vector (mutable)
    QVector< MousePattern >& mousePattern();
    // Return the key pattern vector (mutable)
    QVector< KeyPattern >& keyPattern();
 
    // Check if mouse event matches a pattern code
    bool mouseMatch(MousePatternCode, const QMouseEvent*) const;
    // Check if key event matches a pattern code
    bool keyMatch(KeyPatternCode, const QKeyEvent*) const;
 
protected:
    virtual bool mouseMatch(const MousePattern&, const QMouseEvent*) const;
    virtual bool keyMatch(const KeyPattern&, const QKeyEvent*) const;
 
private:
#if defined(_MSC_VER)
#pragma warning(push)
#pragma warning(disable : 4251)
#endif
    QVector< MousePattern > m_mousePattern;
    QVector< KeyPattern > m_keyPattern;
#if defined(_MSC_VER)
#pragma warning(pop)
#endif
};
 
inline bool operator==(QwtEventPattern::MousePattern b1, QwtEventPattern::MousePattern b2)
{
    return b1.button == b2.button && b1.modifiers == b2.modifiers;
}
 
inline bool operator==(QwtEventPattern::KeyPattern b1, QwtEventPattern::KeyPattern b2)
{
    return b1.key == b2.key && b1.modifiers == b2.modifiers;
}
 
#endif