umbrello  2.32.0
Umbrello UML Modeller is a Unified Modelling Language (UML) diagram program based on KDE Technology
associationline.h
Go to the documentation of this file.
1 /***************************************************************************
2  * This program is free software; you can redistribute it and/or modify *
3  * it under the terms of the GNU General Public License as published by *
4  * the Free Software Foundation; either version 2 of the License, or *
5  * (at your option) any later version. *
6  * *
7  * copyright (C) 2002-2020 *
8  * Umbrello UML Modeller Authors <umbrello-devel@kde.org> *
9  ***************************************************************************/
10 
11 #ifndef ASSOCIATIONLINE_H
12 #define ASSOCIATIONLINE_H
13 
14 #include "basictypes.h"
15 
16 #include <QGraphicsObject>
17 #include <QList>
18 #include <QPen>
19 #include <QPoint>
20 
21 // forward declarations
22 class AssociationWidget;
23 class QDomDocument;
24 class QDomElement;
25 class QPainter;
26 
32 class Symbol : public QGraphicsItem
33 {
34  public:
35  typedef QPair<QPointF, QPointF> SymbolEndPoints;
36 
41  enum SymbolType {
42  None = -1,
50  };
51 
52  explicit Symbol(SymbolType symbolType, QGraphicsItem *parent = 0);
53  virtual ~Symbol();
54 
55  SymbolType symbolType() const;
57 
58  virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget);
59 
60  virtual QRectF boundingRect() const;
61  virtual QPainterPath shape() const;
62 
63  void alignTo(const QLineF& line);
65 
66  QPen pen() const;
67  void setPen(const QPen &pen);
68 
69  QBrush brush() const;
70  void setBrush(const QBrush& brush);
71 
72  private:
73  QPen m_pen;
74  QBrush m_brush;
76 
78  struct SymbolProperty {
79  QRectF boundRect;
80  QPainterPath shape;
81  QLineF axisLine;
83  };
84 
86  static void setupSymbolTable();
87 };
88 
105 class AssociationLine : public QGraphicsObject
106 {
107  Q_OBJECT
108 public:
109  static QString toString(Uml::LayoutType::Enum layout);
110  static Uml::LayoutType::Enum fromString(const QString& layout);
111 
112  explicit AssociationLine(AssociationWidget *association);
113  virtual ~AssociationLine();
114 
115  QPointF point(int index) const;
116  bool setPoint(int index, const QPointF& point);
117  QPointF startPoint() const;
118  QPointF endPoint() const;
119 
120  void addPoint(const QPointF& point);
121  void insertPoint(int index, const QPointF& point);
122  void removePoint(int index);
123 
124  int count() const;
125  void cleanup();
126 
127  void optimizeLinePoints();
128 
129  int closestPointIndex(const QPointF& point, qreal delta = Delta) const;
130  int closestSegmentIndex(const QPointF& point, qreal delta = Delta) const;
131 
132  bool isEndPointIndex(int index) const;
133  bool isEndSegmentIndex(int index) const;
134  bool isAutoLayouted() const;
135 
136  bool enableAutoLayout();
137 
138  bool setEndPoints(const QPointF &start, const QPointF &end);
139 
140  void dumpPoints();
141 
142  bool loadFromXMI1(QDomElement &qElement);
143  void saveToXMI1(QDomDocument &qDoc, QDomElement &qElement);
144 
145  QBrush brush() const;
146  QPen pen() const;
147  void setPen(const QPen &pen);
148  void updatePenStyle();
149 
150  virtual void paint(QPainter* painter, const QStyleOptionGraphicsItem* option, QWidget* widget);
151 
152  QPainterPath path() const;
153 
154  QRectF boundingRect() const;
155  QPainterPath shape() const;
156 
159 
160  void mousePressEvent(QGraphicsSceneMouseEvent *event);
161  void mouseMoveEvent(QGraphicsSceneMouseEvent *event);
162  void mouseReleaseEvent(QGraphicsSceneMouseEvent *event);
163 
164  void hoverEnterEvent(QGraphicsSceneHoverEvent *event);
165  void hoverMoveEvent(QGraphicsSceneHoverEvent *event);
166  void hoverLeaveEvent(QGraphicsSceneHoverEvent *event);
167 
169 
170  void reconstructSymbols();
171 
172 private:
173  void setStartSymbol(Symbol::SymbolType symbolType);
174  void setEndSymbol(Symbol::SymbolType symbolType);
175 
176  void createSubsetSymbol();
177  void removeSubsetSymbol();
178 
181 
182  void alignSymbols();
183 
184  void createSplinePoints();
185 
187  QVector<QPointF> m_points;
193  QGraphicsLineItem *m_collaborationLineItem;
196  QPen m_pen;
198  static QPainterPath createBezierCurve(QVector<QPointF> points);
199  static QPainterPath createOrthogonalPath(QVector<QPointF> points);
200 
201  qreal c1dx{0.0}, c1dy{0.0}, c2dx{0.0}, c2dy{0.0};
202  static const qreal Delta;
203  static const qreal SelectedPointDiameter;
204  static const qreal SelfAssociationMinimumHeight;
205 };
206 
207 #endif
Definition: associationline.h:44
SymbolType symbolType() const
Definition: associationline.cpp:1425
virtual ~Symbol()
Definition: associationline.cpp:1418
QPair< QPointF, QPointF > SymbolEndPoints
Definition: associationline.h:35
qreal c2dx
Definition: associationline.h:201
void alignSymbols()
Definition: associationline.cpp:698
int closestSegmentIndex(const QPointF &point, qreal delta=Delta) const
Definition: associationline.cpp:228
bool isAutoLayouted() const
Definition: associationline.cpp:272
void mouseReleaseEvent(QGraphicsSceneMouseEvent *event)
Definition: associationline.cpp:1221
QPainterPath shape() const
Definition: associationline.cpp:808
Symbol * m_subsetSymbol
subset symbol
Definition: associationline.h:192
void setStartSymbol(Symbol::SymbolType symbolType)
Definition: associationline.cpp:596
virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)
Definition: associationline.cpp:1443
QBrush brush() const
Definition: associationline.cpp:1531
void setPen(const QPen &pen)
Definition: associationline.cpp:1521
QPointF endPoint() const
Definition: associationline.cpp:113
void setEndSymbol(Symbol::SymbolType symbolType)
Definition: associationline.cpp:620
void createSubsetSymbol()
Definition: associationline.cpp:642
QRectF boundRect
Definition: associationline.h:79
void addPoint(const QPointF &point)
Definition: associationline.cpp:118
void setLayout(Uml::LayoutType::Enum layout)
Definition: associationline.cpp:851
Definition: associationline.h:47
static QPainterPath createBezierCurve(QVector< QPointF > points)
Definition: associationline.cpp:934
A structure to hold a table of values for all symbols.
Definition: associationline.h:78
Definition: associationline.h:46
bool isEndSegmentIndex(int index) const
Definition: associationline.cpp:263
Definition: associationline.h:49
Uml::LayoutType::Enum layout() const
Definition: associationline.cpp:842
Definition: associationline.h:48
SymbolEndPoints endPoints
Definition: associationline.h:82
int m_activeSegmentIndex
index of active segment
Definition: associationline.h:189
void hoverMoveEvent(QGraphicsSceneHoverEvent *event)
Definition: associationline.cpp:1257
Symbol * m_collaborationLineHead
arrow head drawn at end of m_collaborationLineItem
Definition: associationline.h:194
static QString toString(Uml::LayoutType::Enum layout)
Definition: associationline.cpp:819
QGraphicsLineItem * m_collaborationLineItem
parallel arrow line drawn in case of collaboration message
Definition: associationline.h:193
Definition: associationline.h:43
This class represents an association inside a diagram. Bugs and comments to umbrello-devel@kde.org or https://bugs.kde.org.
Definition: associationwidget.h:51
int m_activePointIndex
index of active point which can be dragged to modify association line
Definition: associationline.h:188
static const qreal Delta
default delta for fuzzy recognition of points closer to point
Definition: associationline.h:202
int count() const
Definition: associationline.cpp:152
QPen pen() const
Definition: associationline.cpp:432
void calculateInitialEndPoints()
Definition: associationline.cpp:483
Definition: associationline.h:105
qreal c2dy
Definition: associationline.h:201
SymbolEndPoints symbolEndPoints() const
Definition: associationline.cpp:1505
void setBrush(const QBrush &brush)
Definition: associationline.cpp:1539
QBrush brush() const
Definition: associationline.cpp:414
bool m_autoLayoutSpline
Definition: associationline.h:197
SymbolType
Definition: associationline.h:41
virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)
Definition: associationline.cpp:1014
Symbol * m_startSymbol
symbol drawn at the end of "first" line segment
Definition: associationline.h:190
Definition: associationline.h:42
AssociationWidget * m_associationWidget
association widget for which this line represents
Definition: associationline.h:186
void mouseMoveEvent(QGraphicsSceneMouseEvent *event)
Definition: associationline.cpp:1162
void optimizeLinePoints()
Definition: associationline.cpp:176
void removePoint(int index)
Definition: associationline.cpp:138
bool setEndPoints(const QPointF &start, const QPointF &end)
Definition: associationline.cpp:291
void updatePenStyle()
Definition: associationline.cpp:466
QPen m_pen
pen used to draw Symbol
Definition: associationline.h:73
QPen m_pen
pen used to draw an association line
Definition: associationline.h:196
Uml::LayoutType::Enum m_layout
Definition: associationline.h:195
Symbol(SymbolType symbolType, QGraphicsItem *parent=0)
Definition: associationline.cpp:1407
qreal c1dy
Definition: associationline.h:201
bool loadFromXMI1(QDomElement &qElement)
Definition: associationline.cpp:328
virtual ~AssociationLine()
Definition: associationline.cpp:63
void createSplinePoints()
Definition: associationline.cpp:867
SymbolType m_symbolType
current symbol being represented by this item
Definition: associationline.h:75
QPainterPath path() const
Definition: associationline.cpp:760
void alignTo(const QLineF &line)
Definition: associationline.cpp:1488
int closestPointIndex(const QPointF &point, qreal delta=Delta) const
Definition: associationline.cpp:202
void removeCollaborationLine()
Definition: associationline.cpp:684
virtual QRectF boundingRect() const
Definition: associationline.cpp:1462
QVector< QPointF > m_points
points representing the association line
Definition: associationline.h:187
qreal c1dx
Definition: associationline.h:201
QRectF boundingRect() const
Definition: associationline.cpp:796
static SymbolProperty symbolTable[Symbol::Count]
a table which stores all symbol properties
Definition: associationline.h:85
AssociationLine(AssociationWidget *association)
Definition: associationline.cpp:41
static void setupSymbolTable()
Definition: associationline.cpp:1328
static const qreal SelfAssociationMinimumHeight
minimum height for self association&#39;s loop
Definition: associationline.h:204
static const qreal SelectedPointDiameter
radius of circles drawn to show "selection"
Definition: associationline.h:203
void cleanup()
Definition: associationline.cpp:160
QPainterPath shape
Definition: associationline.h:80
void insertPoint(int index, const QPointF &point)
Definition: associationline.cpp:127
bool enableAutoLayout()
Definition: associationline.cpp:277
QLineF axisLine
Definition: associationline.h:81
void reconstructSymbols()
Definition: associationline.cpp:524
void setSymbolType(SymbolType symbolType)
Definition: associationline.cpp:1433
void removeSubsetSymbol()
Definition: associationline.cpp:653
void mousePressEvent(QGraphicsSceneMouseEvent *event)
Definition: associationline.cpp:1138
void hoverEnterEvent(QGraphicsSceneHoverEvent *event)
Definition: associationline.cpp:1233
Definition: associationline.h:32
Definition: associationline.h:45
QPen pen() const
Definition: associationline.cpp:1513
bool isEndPointIndex(int index) const
Definition: associationline.cpp:252
bool setPoint(int index, const QPointF &point)
Definition: associationline.cpp:87
QPointF startPoint() const
Definition: associationline.cpp:105
void hoverLeaveEvent(QGraphicsSceneHoverEvent *event)
Definition: associationline.cpp:1279
void setPen(const QPen &pen)
Definition: associationline.cpp:440
Symbol * m_endSymbol
symbol drawn at the end of "last" line segment
Definition: associationline.h:191
void createCollaborationLine()
Definition: associationline.cpp:662
void dumpPoints()
Definition: associationline.cpp:317
QBrush m_brush
brush used to fill Symbol
Definition: associationline.h:74
void saveToXMI1(QDomDocument &qDoc, QDomElement &qElement)
Definition: associationline.cpp:382
static QPainterPath createOrthogonalPath(QVector< QPointF > points)
Definition: associationline.cpp:970
QPointF point(int index) const
Definition: associationline.cpp:75
static Uml::LayoutType::Enum fromString(const QString &layout)
Definition: associationline.cpp:827
virtual QPainterPath shape() const
Definition: associationline.cpp:1472
Enum
Definition: basictypes.h:144