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