· · ·
item.h
1 /***************************************************************************
2 ** **
3 ** QCustomPlot, an easy to use, modern plotting widget for Qt **
4 ** Copyright (C) 2011, 2012, 2013, 2014 Emanuel Eichhammer **
5 ** **
6 ** This program is free software: you can redistribute it and/or modify **
7 ** it under the terms of the GNU General Public License as published by **
8 ** the Free Software Foundation, either version 3 of the License, or **
9 ** (at your option) any later version. **
10 ** **
11 ** This program is distributed in the hope that it will be useful, **
12 ** but WITHOUT ANY WARRANTY; without even the implied warranty of **
13 ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the **
14 ** GNU General Public License for more details. **
15 ** **
16 ** You should have received a copy of the GNU General Public License **
17 ** along with this program. If not, see http://www.gnu.org/licenses/. **
18 ** **
19 ****************************************************************************
20 ** Author: Emanuel Eichhammer **
21 ** Website/Contact: http://www.qcustomplot.com/ **
22 ** Date: 07.04.14 **
23 ** Version: 1.2.1 **
24 ****************************************************************************/
25
26 #ifndef QCP_ITEM_H
27 #define QCP_ITEM_H
28
29 #include "global.h"
30 #include "layer.h"
31 #include "axis.h"
32
33 class QCPPainter;
34 class QCustomPlot;
35 class QCPItemPosition;
36 class QCPAbstractItem;
37 class QCPAxisRect;
38
39 class QCP_LIB_DECL QCPItemAnchor
40 {
41 public:
42 QCPItemAnchor(QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString name, int anchorId=-1);
43 virtual ~QCPItemAnchor();
44
45 // getters:
46 QString name() const { return mName; }
47 virtual QPointF pixelPoint() const;
48
49 protected:
50 // property members:
51 QString mName;
52
53 // non-property members:
54 QCustomPlot *mParentPlot;
55 QCPAbstractItem *mParentItem;
56 int mAnchorId;
57 QSet<QCPItemPosition*> mChildren;
58
59 // introduced virtual methods:
60 virtual QCPItemPosition *toQCPItemPosition() { return 0; }
61
62 // non-virtual methods:
63 void addChild(QCPItemPosition* pos); // called from pos when this anchor is set as parent
64 void removeChild(QCPItemPosition *pos); // called from pos when its parent anchor is reset or pos deleted
65
66 private:
67 Q_DISABLE_COPY(QCPItemAnchor)
68
69 friend class QCPItemPosition;
70 };
71
72
73
74 class QCP_LIB_DECL QCPItemPosition : public QCPItemAnchor
75 {
76 public:
83 enum PositionType { ptAbsolute
84 ,ptViewportRatio
85
86
87 ,ptAxisRectRatio
88
89
90 ,ptPlotCoords
91 };
92
93 QCPItemPosition(QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString name);
94 virtual ~QCPItemPosition();
95
96 // getters:
97 PositionType type() const { return mPositionType; }
98 QCPItemAnchor *parentAnchor() const { return mParentAnchor; }
99 double key() const { return mKey; }
100 double value() const { return mValue; }
101 QPointF coords() const { return QPointF(mKey, mValue); }
102 QCPAxis *keyAxis() const { return mKeyAxis.data(); }
103 QCPAxis *valueAxis() const { return mValueAxis.data(); }
104 QCPAxisRect *axisRect() const;
105 virtual QPointF pixelPoint() const;
106
107 // setters:
108 void setType(PositionType type);
109 bool setParentAnchor(QCPItemAnchor *parentAnchor, bool keepPixelPosition=false);
110 void setCoords(double key, double value);
111 void setCoords(const QPointF &coords);
112 void setAxes(QCPAxis* keyAxis, QCPAxis* valueAxis);
113 void setAxisRect(QCPAxisRect *axisRect);
114 void setPixelPoint(const QPointF &pixelPoint);
115
116 protected:
117 // property members:
118 PositionType mPositionType;
119 QPointer<QCPAxis> mKeyAxis, mValueAxis;
120 QPointer<QCPAxisRect> mAxisRect;
121 double mKey, mValue;
122 QCPItemAnchor *mParentAnchor;
123
124 // reimplemented virtual methods:
125 virtual QCPItemPosition *toQCPItemPosition() { return this; }
126
127 private:
128 Q_DISABLE_COPY(QCPItemPosition)
129
130 };
131
132
133 class QCP_LIB_DECL QCPAbstractItem : public QCPLayerable
134 {
135 Q_OBJECT
137 Q_PROPERTY(bool clipToAxisRect READ clipToAxisRect WRITE setClipToAxisRect)
138 Q_PROPERTY(QCPAxisRect* clipAxisRect READ clipAxisRect WRITE setClipAxisRect)
139 Q_PROPERTY(bool selectable READ selectable WRITE setSelectable NOTIFY selectableChanged)
140 Q_PROPERTY(bool selected READ selected WRITE setSelected NOTIFY selectionChanged)
142 public:
143 QCPAbstractItem(QCustomPlot *parentPlot);
144 virtual ~QCPAbstractItem();
145
146 // getters:
147 bool clipToAxisRect() const { return mClipToAxisRect; }
148 QCPAxisRect *clipAxisRect() const;
149 bool selectable() const { return mSelectable; }
150 bool selected() const { return mSelected; }
151
152 // setters:
153 void setClipToAxisRect(bool clip);
154 void setClipAxisRect(QCPAxisRect *rect);
155 Q_SLOT void setSelectable(bool selectable);
156 Q_SLOT void setSelected(bool selected);
157
158 // reimplemented virtual methods:
159 virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const = 0;
160
161 // non-virtual methods:
162 QList<QCPItemPosition*> positions() const { return mPositions; }
163 QList<QCPItemAnchor*> anchors() const { return mAnchors; }
164 QCPItemPosition *position(const QString &name) const;
165 QCPItemAnchor *anchor(const QString &name) const;
166 bool hasAnchor(const QString &name) const;
167
168 signals:
169 void selectionChanged(bool selected);
170 void selectableChanged(bool selectable);
171
172 protected:
173 // property members:
174 bool mClipToAxisRect;
175 QPointer<QCPAxisRect> mClipAxisRect;
176 QList<QCPItemPosition*> mPositions;
177 QList<QCPItemAnchor*> mAnchors;
178 bool mSelectable, mSelected;
179
180 // reimplemented virtual methods:
181 virtual QCP::Interaction selectionCategory() const;
182 virtual QRect clipRect() const;
183 virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const;
184 virtual void draw(QCPPainter *painter) = 0;
185 // events:
186 virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged);
187 virtual void deselectEvent(bool *selectionStateChanged);
188
189 // introduced virtual methods:
190 virtual QPointF anchorPixelPoint(int anchorId) const;
191
192 // non-virtual methods:
193 double distSqrToLine(const QPointF &start, const QPointF &end, const QPointF &point) const;
194 double rectSelectTest(const QRectF &rect, const QPointF &pos, bool filledRect) const;
195 QCPItemPosition *createPosition(const QString &name);
196 QCPItemAnchor *createAnchor(const QString &name, int anchorId);
197
198 private:
199 Q_DISABLE_COPY(QCPAbstractItem)
200
201 friend class QCustomPlot;
202 friend class QCPItemAnchor;
203 };
204
205 #endif // QCP_ITEM_H
Generated with Doxygen 1.8.1.2