qwt_figure.h

#ifndef QWT_FIGURE_H
#define QWT_FIGURE_H
// stl
#include <memory>
 
// Qt
#include <QFrame>
class QResizeEvent;
class QPaintEvent;
 
// qwt
#include "qwt_global.h"
#include "qwt_axis.h"
class QwtPlot;
 
class QWT_EXPORT QwtFigure : public QFrame
{
    Q_OBJECT
    QWT_DECLARE_PRIVATE(QwtFigure)
public:
    QwtFigure(QWidget* parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags());
    virtual ~QwtFigure();
    // Add a widget with normalized coordinates/使用归一化坐标添加widget
    void addWidget(QWidget* widget, qreal left, qreal top, qreal width, qreal height);
    void addWidget(QWidget* widget,
                   int rowCnt,
                   int colCnt,
                   int row,
                   int col,
                   int rowSpan  = 1,
                   int colSpan  = 1,
                   qreal wspace = 0.0,
                   qreal hspace = 0.0);
    // Add a plot with normalized coordinates/使用归一化坐标添加绘图
    void addAxes(QwtPlot* plot, const QRectF& rect);
 
    // Add a plot with normalized coordinates using separate parameters/使用分离参数和归一化坐标添加窗口部件
    void addAxes(QwtPlot* plot, qreal left, qreal top, qreal width, qreal height);
 
    // Add a plot by grid layout/添加窗口部件到网格布局
    void addGridAxes(QwtPlot* plot,
                     int rowCnt,
                     int colCnt,
                     int row,
                     int col,
                     int rowSpan  = 1,
                     int colSpan  = 1,
                     qreal wspace = 0.0,
                     qreal hspace = 0.0);
 
    // 改变已经添加的窗口的位置占比,如果窗口还没添加，此函数无效
    void setWidgetNormPos(QWidget* widget, const QRectF& rect);
 
    // Get all axes (plots) in the figure（not contain parasite axes）/获取图形中的所有坐标轴（绘图）(不包含寄生轴)
    QList< QwtPlot* > allAxes(bool byZOrder = false) const;
 
    // Check if the figure has any axes/检查图形是否有任意绘图
    bool hasAxes() const;
 
    // Check if the figure has plot/检查图形是否存在plot
    bool hasAxes(QwtPlot* plot) const;
 
    // Remove a specific axes (plot) from the figure/从图形中移除特定的坐标轴（绘图）/This function does not destroy the QwtPlot object
    void removeAxes(QwtPlot* plot);
 
    //  Take a specific axes (plot) from the figure without deleting it/从图形中取出特定的坐标轴（绘图）但不删除它
    bool takeAxes(QwtPlot* plot);
 
    // Clear all axes from the figure/清除图形中的所有坐标轴
    void clear();
 
    //  Get the size of the figure in inches/获取图形的英寸尺寸
    QSize getSizeInches() const;
 
    // Set the size of the figure in inches/设置图形的英寸尺寸
    void setSizeInches(float width, float height);
    void setSizeInches(const QSizeF& size);
 
    //  Set/Get the face color of the figure/设置图形的背景颜色
    void setFaceColor(const QColor& color);
    QColor faceColor() const;
 
    // Set/Get the face brush of the figure/设置图形的背景画刷
    void setFaceBrush(const QBrush& brush);
    QBrush faceBrush() const;
 
    // Set/Get the edge color of the figure/设置图形的边缘颜色
    void setEdgeColor(const QColor& color);
    QColor edgeColor() const;
 
    // Set/Get the edge line width of the figure/设置图形的边缘线宽
    void setEdgeLineWidth(int width);
    int edgeLineWidth() const;
 
    // Parasite Axes
    // Create parasite axes for a host plot/为宿主绘图创建寄生轴
    QwtPlot* createParasiteAxes(QwtPlot* hostPlot, QwtAxis::Position enableAxis);
    // Get all parasite axes for a host plot/获取宿主绘图的所有寄生轴
    QList< QwtPlot* > getParasiteAxes(QwtPlot* hostPlot) const;
 
    // Save methods / 保存方法
    // Save the figure to a QPixmap with specified DPI/使用指定DPI将图形保存为QPixmap
    QPixmap saveFig(int dpi = -1) const;
 
    // Save the figure to a QPixmap with specified size in inches/使用指定英寸尺寸将图形保存为QPixmap
    QPixmap saveFig(QSizeF& inchesSize) const;
 
    // Save the figure to a file with specified DPI/使用指定DPI将图形保存到文件
    bool saveFig(const QString& filename, int dpi = -1) const;
 
    // Set the current axes (plot)/设置当前坐标轴（绘图）
    void setCurrentAxes(QwtPlot* plot);
    void sca(QwtPlot* plot);
 
    // Get the current axes (plot)/获取当前坐标轴（绘图）
    QwtPlot* currentAxes() const;
    QwtPlot* gca() const;
 
    // Get the normalized rectangle for a axes/获取绘图的归一化矩形
    QRectF axesNormRect(QwtPlot* plot) const;
    // Get the normalized rectangle for a child widget/获取子窗口的的归一化矩形
    QRectF widgetNormRect(QWidget* w) const;
    // 获取在此坐标下的绘图，如果此坐标下没有，则返回nullptr，存在寄生轴情况只返回宿主轴
    QwtPlot* plotUnderPos(const QPoint& pos) const;
    // 通过真实位置计算归一化坐标
    QRectF calcNormRect(const QRect& geoRect) const;
    // 计算正规矩形
    QRect calcActualRect(const QRectF& normRect);
    // 更新所有的绘图
    void replotAll();
    //=============AxisAlignment==================
    // 添加轴对齐配置
    void addAxisAlignment(const QList< QwtPlot* >& plots, int axisId);
    // 移除指定的轴对齐配置
    bool removeAxisAlignment(const QList< QwtPlot* >& plots, int axisId);
    // 清除所有轴对齐配置
    void clearAxisAlignment();
    // 应用所有轴对齐配置，对记录的plot和轴进行对齐
    void applyAllAxisAlignments(bool replot = true);
    // 应用指定轴ID的所有对齐配置
    void applyAlignmentsForAxis(int axisId);
Q_SIGNALS:
    void axesAdded(QwtPlot* newAxes);
 
    void axesRemoved(QwtPlot* removedAxes);
 
    void figureCleared();
 
    void currentAxesChanged(QwtPlot* current);
 
public:
    // QwtPlot轴对齐函数
    static void alignAxes(QList< QwtPlot* > plots, int axisId, bool update = true);
 
protected:
    void paintEvent(QPaintEvent* event) override;
    void resizeEvent(QResizeEvent* event) override;
};
 
#endif  // QWT_FIGURE_H