umbrello 2.31.90
Umbrello UML Modeller is a Unified Modelling Language (UML) diagram program based on KDE Technology
associationwidget.h
Go to the documentation of this file.
1/*
2 SPDX-License-Identifier: GPL-2.0-or-later
3 SPDX-FileCopyrightText: 2002-2020 Umbrello UML Modeller Authors <umbrello-devel@kde.org>
4*/
5
6#ifndef ASSOCIATIONWIDGET_H
7#define ASSOCIATIONWIDGET_H
8
11#include "linkwidget.h"
12#include "messagewidgetlist.h"
13#include "umlwidgetlist.h"
14#include "widgetbase.h"
15
16class AssociationLine;
18class UMLScene;
19class UMLAssociation;
20class UMLAttribute;
22class UMLOperation;
23
47{
48 Q_OBJECT
49public:
50 static AssociationWidget* create(UMLScene *scene);
52 (UMLScene *scene, UMLWidget* WidgetA,
53 Uml::AssociationType::Enum assocType, UMLWidget* WidgetB,
54 UMLObject *umlobject = 0);
55
56 virtual ~AssociationWidget();
57
58 virtual void setUMLObject(UMLObject *obj);
59
60 //---------- LinkWidget Interface methods implementation from now on.
61
62 virtual void lwSetFont(QFont font);
64
65 virtual UMLOperation *operation();
66 virtual void setOperation(UMLOperation *op);
67
68 virtual QString customOpText();
69 virtual void setCustomOpText(const QString &opText);
70
71 virtual void resetTextPositions();
72
73 virtual void setMessageText(FloatingTextWidget *ft);
74 virtual void setText(FloatingTextWidget *ft, const QString &newText);
75
76 virtual bool showPropertiesDialog();
77
78 virtual QString lwOperationText();
79 virtual UMLClassifier *lwClassifier();
80 virtual void setOperationText(const QString &op);
81
82 virtual void constrainTextPos(qreal &textX, qreal &textY,
83 qreal textWidth, qreal textHeight,
85
86 virtual void calculateNameTextSegment();
87
88 //---------- End LinkWidget Interface methods implementation.
89
91 UMLAttribute* attribute() const;
92
93// AssociationWidget& operator=(const AssociationWidget& other);
94 bool operator==(const AssociationWidget& other) const;
95 bool operator!=(AssociationWidget& other) const;
96
98
100 QString name() const;
101 void setName(const QString &strRole);
102 void setStereotype(const QString &stereo);
103
105 QString roleName(Uml::RoleType::Enum role) const;
106 void setRoleName(const QString &strRole, Uml::RoleType::Enum role);
107
108 QString roleDocumentation(Uml::RoleType::Enum role) const;
109 void setRoleDocumentation(const QString& doc, Uml::RoleType::Enum role);
110
112 QString multiplicity(Uml::RoleType::Enum role) const;
113 void setMultiplicity(const QString& text, Uml::RoleType::Enum role);
114
117
121
126
127 bool containsAsEndpoint(UMLWidget* widget);
128
131
132 bool isCollaboration() const;
133 bool isSelf() const;
134
135 QString toString() const;
136
137 bool isActivated() const;
138 void setActivated(bool active);
139
141
142 virtual bool activate(IDChangeLog *changeLog = 0);
143 virtual QRectF boundingRect() const;
144 virtual QPainterPath shape() const;
145
146 void widgetMoved(UMLWidget* widget, qreal x, qreal y);
147
149
150 UMLWidget* onWidget(const QPointF &p);
151 bool onAssociation(const QPointF& point);
152 bool onAssocClassLine(const QPointF& point);
153
155 void createAssocClassLine(ClassifierWidget* classifierWidget,
156 int linePathSegmentIndex);
157
158 void selectAssocClassLine(bool sel = true);
161
162 void setXEntireAssoc(qreal x);
163 void setYEntireAssoc(qreal y);
164
165 void moveMidPointsBy(qreal x, qreal y);
166 void moveEntireAssoc(qreal x, qreal y);
167
168 QFont font() const;
169
170 virtual void setTextColor(const QColor &color);
171 virtual void setLineColor(const QColor &color);
172 virtual void setLineWidth(uint width);
173
175
176 void clipSize();
177
178 bool loadFromXMI1(QDomElement& qElement, const UMLWidgetList& widgets,
179 const MessageWidgetList* messages);
180 virtual bool loadFromXMI1(QDomElement& qElement);
181 virtual void saveToXMI1(QXmlStreamWriter& writer);
182
183 void cleanup();
184
185 bool isPointAddable();
186 bool isPointRemovable();
187 bool isAutoLayouted();
188 bool isLayoutChangeable();
189
190 virtual void mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event);
191 virtual void mouseMoveEvent(QGraphicsSceneMouseEvent *event);
192 virtual void mousePressEvent(QGraphicsSceneMouseEvent *event);
193 virtual void mouseReleaseEvent(QGraphicsSceneMouseEvent *event);
194
195 virtual void setSelected(bool _select);
196
197public Q_SLOTS: //:TODO: all virtual?
198 virtual void slotMenuSelection(QAction* action);
201
202 void syncToModel();
203
204protected:
205 virtual void contextMenuEvent(QGraphicsSceneContextMenuEvent *event);
206
207 virtual void hoverEnterEvent(QGraphicsSceneHoverEvent *event);
208 virtual void hoverLeaveEvent(QGraphicsSceneHoverEvent *event);
209 virtual void hoverMoveEvent(QGraphicsSceneHoverEvent *event);
210
211private:
214 void setTextPositionRelatively(Uml::TextRole::Enum role, const QPointF &oldPosition);
215 void setFloatingText(Uml::TextRole::Enum role, const QString& text, FloatingTextWidget* &ft);
216
218
219 void setUMLAssociation(UMLAssociation * assoc);
220
222
223 static Uml::Region::Enum findPointRegion(const QRectF& rect, const QPointF& pos);
224 static qreal findInterceptOnEdge(const QRectF &rect, Uml::Region::Enum region, const QPointF &point);
225 static QLineF::IntersectType intersect(const QRectF &rect, const QLineF &line,
226 QPointF* intersectionPoint);
227
228 void moveEvent(QGraphicsSceneMouseEvent *me);
229
231
232 static QPointF swapXY(const QPointF &p);
233
234 // not used at the moment
235 // static QPointF calculatePointAtDistance(const QPointF &P1, const QPointF &P2, float Distance);
236 // static QPointF calculatePointAtDistanceOnPerpendicular(const QPointF &P1, const QPointF &P2, float Distance);
237 // static float perpendicularProjection(const QPointF& P1, const QPointF& P2, const QPointF& P3, QPointF& ResultingPoint);
238
239 static QPointF midPoint(const QPointF& p0, const QPointF& p1);
240
245
246 void updateRegionLineCount(int index, int totalCount,
248
249 void updateAssociations(int totalCount, Uml::Region::Enum region, Uml::RoleType::Enum role);
250
252
253 void doUpdates(const QPointF &otherP, Uml::RoleType::Enum role);
254
255 void setChangeWidget(const QString &strChangeWidget, Uml::RoleType::Enum role);
256
257 bool checkAddPoint(const QPointF &scenePos);
258 bool checkRemovePoint(const QPointF &scenePos);
260
261 bool linePathStartsAt(const UMLWidget* widget);
262
263 void insertIntoLists(qreal position, const AssociationWidget* assoc);
264
265 qreal m_positions[100];
268
270
279
287
289 QGraphicsLineItem *m_pAssocClassLine;
290 QGraphicsRectItem *m_pAssocClassLineSel0;
291 QGraphicsRectItem *m_pAssocClassLineSel1;
292
299
300};
301
302#endif
QList< QPointer< AssociationWidget > > AssociationWidgetList
Definition: associationwidgetlist.h:15
Definition: associationline.h:101
Definition: associationwidgetrole.h:27
This class represents an association inside a diagram. Bugs and comments to umbrello-devel@kde....
Definition: associationwidget.h:47
bool linePathStartsAt(const UMLWidget *widget)
Definition: associationwidget.cpp:1185
Uml::ID::Type widgetLocalIDForRole(Uml::RoleType::Enum role) const
Definition: associationwidget.cpp:1468
QPointF m_oldChangeAPoint
Position of role A changeability floatingtext saved by saveIdealTextPositions()
Definition: associationwidget.h:283
void setXEntireAssoc(qreal x)
Definition: associationwidget.cpp:3796
virtual QRectF boundingRect() const
Definition: associationwidget.cpp:3855
QPointF calculateTextPosition(Uml::TextRole::Enum role)
Definition: associationwidget.cpp:2460
void syncToModel()
Definition: associationwidget.cpp:1765
virtual void hoverLeaveEvent(QGraphicsSceneHoverEvent *event)
Definition: associationwidget.cpp:3951
void setWidgetForRole(UMLWidget *widget, Uml::RoleType::Enum role)
Definition: associationwidget.cpp:787
void cleanup()
Definition: associationwidget.cpp:1239
void doUpdates(const QPointF &otherP, Uml::RoleType::Enum role)
Definition: associationwidget.cpp:1706
void createPointsSelfAssociation()
Definition: associationwidget.cpp:1943
virtual void slotMenuSelection(QAction *action)
Definition: associationwidget.cpp:2922
void setTextPosition(Uml::TextRole::Enum role)
Definition: associationwidget.cpp:2714
void setActivated(bool active)
Definition: associationwidget.cpp:1757
virtual void setOperationText(const QString &op)
Definition: associationwidget.cpp:459
void slotAttributeChanged()
Definition: associationwidget.cpp:3889
void moveEntireAssoc(qreal x, qreal y)
Definition: associationwidget.cpp:3836
virtual void setLineColor(const QColor &color)
Definition: associationwidget.cpp:3158
void moveMidPointsBy(qreal x, qreal y)
Definition: associationwidget.cpp:3820
virtual void setOperation(UMLOperation *op)
Definition: associationwidget.cpp:306
void setYEntireAssoc(qreal y)
Definition: associationwidget.cpp:3808
QPointF m_eventScenePos
holds scene pos of contextMenuEvent()
Definition: associationwidget.h:298
bool loadFromXMI1(QDomElement &qElement, const UMLWidgetList &widgets, const MessageWidgetList *messages)
Definition: associationwidget.cpp:4027
bool isCollaboration() const
Definition: associationwidget.cpp:1379
void mergeAssociationDataIntoUMLRepresentation()
Definition: associationwidget.cpp:1799
FloatingTextWidget * m_nameWidget
displays the name of this association
Definition: associationwidget.h:297
static AssociationWidget * create(UMLScene *scene)
Definition: associationwidget.cpp:98
AssociationWidgetRole m_role[2]
Definition: associationwidget.h:296
bool isAutoLayouted()
Definition: associationwidget.cpp:1308
int getRegionCount(Uml::Region::Enum region, Uml::RoleType::Enum role)
Definition: associationwidget.cpp:3302
Uml::Visibility::Enum visibility(Uml::RoleType::Enum role) const
Definition: associationwidget.cpp:1077
void setMultiplicity(const QString &text, Uml::RoleType::Enum role)
Definition: associationwidget.cpp:1064
bool checkAddPoint(const QPointF &scenePos)
Definition: associationwidget.cpp:3174
QString name() const
Definition: associationwidget.cpp:869
virtual UMLOperation * operation()
Definition: associationwidget.cpp:297
void computeAssocClassLine()
Definition: associationwidget.cpp:2835
QPointF m_oldRoleAPoint
Position of role A name floatingtext saved by saveIdealTextPositions()
Definition: associationwidget.h:285
bool isPointAddable()
Return state if the association line point in the near of the last context menu event position is add...
Definition: associationwidget.cpp:1285
virtual QString customOpText()
Definition: associationwidget.cpp:321
virtual bool showPropertiesDialog()
Definition: associationwidget.cpp:418
UMLWidget * onWidget(const QPointF &p)
Definition: associationwidget.cpp:3725
FloatingTextWidget * changeabilityWidget(Uml::RoleType::Enum role) const
Definition: associationwidget.cpp:830
AssociationLine * m_associationLine
the definition points for the association line
Definition: associationwidget.h:293
virtual void saveToXMI1(QXmlStreamWriter &writer)
Definition: associationwidget.cpp:3967
void createPointsException()
Definition: associationwidget.cpp:1997
void createAssocClassLine()
Definition: associationwidget.cpp:2790
int m_positions_len
auxiliary variable for updateAssociations()
Definition: associationwidget.h:266
virtual void setSelected(bool _select)
Definition: associationwidget.cpp:3688
virtual void constrainTextPos(qreal &textX, qreal &textY, qreal textWidth, qreal textHeight, Uml::TextRole::Enum tr)
Definition: associationwidget.cpp:2569
void updatePointsSelfAssociation()
Definition: associationwidget.cpp:1970
UMLAssociation * association() const
Definition: associationwidget.cpp:519
QPointF m_oldMultiBPoint
Position of role B multiplicity floatingtext saved by saveIdealTextPositions()
Definition: associationwidget.h:282
UMLAttribute * attribute() const
Definition: associationwidget.cpp:532
AssociationLine * associationLine() const
Definition: associationwidget.cpp:657
virtual void resetTextPositions()
Definition: associationwidget.cpp:339
void calculateEndingPoints()
Definition: associationwidget.cpp:1610
QGraphicsLineItem * m_pAssocClassLine
used for connecting assoc. class
Definition: associationwidget.h:289
void updateRegionLineCount(int index, int totalCount, Uml::Region::Enum region, Uml::RoleType::Enum role)
Definition: associationwidget.cpp:3539
QFont font() const
Definition: associationwidget.cpp:3106
FloatingTextWidget * nameWidget() const
Definition: associationwidget.cpp:812
QString roleName(Uml::RoleType::Enum role) const
Definition: associationwidget.cpp:944
bool isPointRemovable()
Return state if the association line point in the near of the last context menu event position is rem...
Definition: associationwidget.cpp:1300
void setUMLAssociation(UMLAssociation *assoc)
Definition: associationwidget.cpp:1330
void setAssociationType(Uml::AssociationType::Enum type)
Definition: associationwidget.cpp:1413
QGraphicsRectItem * m_pAssocClassLineSel0
selection decoration for the start point of the assoc. class line
Definition: associationwidget.h:290
void clipSize()
Definition: associationwidget.cpp:3900
bool m_activated
flag which is true if the activate method has been called for this class instance
Definition: associationwidget.h:269
virtual void mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event)
Definition: associationwidget.cpp:1518
Uml::AssociationType::Enum m_associationType
is only used if m_pObject is not set
Definition: associationwidget.h:295
static Uml::Region::Enum findPointRegion(const QRectF &rect, const QPointF &pos)
Definition: associationwidget.cpp:2102
virtual void setMessageText(FloatingTextWidget *ft)
Definition: associationwidget.cpp:370
static QPointF swapXY(const QPointF &p)
Definition: associationwidget.cpp:2159
void updateAssociations(int totalCount, Uml::Region::Enum region, Uml::RoleType::Enum role)
Definition: associationwidget.cpp:3463
QString roleDocumentation(Uml::RoleType::Enum role) const
Definition: associationwidget.cpp:997
static QLineF::IntersectType intersect(const QRectF &rect, const QLineF &line, QPointF *intersectionPoint)
Definition: associationwidget.cpp:3339
UMLWidget * widgetForRole(Uml::RoleType::Enum role) const
Definition: associationwidget.cpp:1231
void setRoleName(const QString &strRole, Uml::RoleType::Enum role)
Definition: associationwidget.cpp:957
bool containsAsEndpoint(UMLWidget *widget)
Definition: associationwidget.cpp:1371
void setTextPositionRelatively(Uml::TextRole::Enum role, const QPointF &oldPosition)
Definition: associationwidget.cpp:2738
bool operator!=(AssociationWidget &other) const
Definition: associationwidget.cpp:649
void setRoleDocumentation(const QString &doc, Uml::RoleType::Enum role)
Definition: associationwidget.cpp:986
bool checkAutoLayoutSpline()
Definition: associationwidget.cpp:3258
bool onAssociation(const QPointF &point)
Definition: associationwidget.cpp:3774
virtual void mousePressEvent(QGraphicsSceneMouseEvent *event)
Definition: associationwidget.cpp:2884
virtual UMLClassifier * operationOwner()
Definition: associationwidget.cpp:279
virtual void setText(FloatingTextWidget *ft, const QString &newText)
Definition: associationwidget.cpp:389
QString toString() const
Definition: associationwidget.cpp:1485
static QPointF midPoint(const QPointF &p0, const QPointF &p1)
Definition: associationwidget.cpp:2545
virtual void lwSetFont(QFont font)
Definition: associationwidget.cpp:265
FloatingTextWidget * multiplicityWidget(Uml::RoleType::Enum role) const
Definition: associationwidget.cpp:802
static qreal findInterceptOnEdge(const QRectF &rect, Uml::Region::Enum region, const QPointF &point)
Definition: associationwidget.cpp:3367
qreal m_positions[100]
auxiliary variable for updateAssociations()
Definition: associationwidget.h:265
bool onAssocClassLine(const QPointF &point)
Definition: associationwidget.cpp:3747
void removeAssocClassLine()
Definition: associationwidget.cpp:2773
Uml::AssociationType::Enum associationType() const
Definition: associationwidget.cpp:1400
virtual UMLClassifier * lwClassifier()
Definition: associationwidget.cpp:446
void saveIdealTextPositions()
Definition: associationwidget.cpp:1852
virtual void hoverEnterEvent(QGraphicsSceneHoverEvent *event)
Definition: associationwidget.cpp:3943
void selectAssocClassLine(bool sel=true)
Definition: associationwidget.cpp:2873
void setStereotype(const QString &stereo)
Definition: associationwidget.cpp:916
bool operator==(const AssociationWidget &other) const
Definition: associationwidget.cpp:600
virtual void setLineWidth(uint width)
Definition: associationwidget.cpp:3166
QPointF m_oldChangeBPoint
Position of role B changeability floatingtext saved by saveIdealTextPositions()
Definition: associationwidget.h:284
AssociationWidget(UMLScene *scene)
Definition: associationwidget.cpp:67
void setVisibility(Uml::Visibility::Enum value, Uml::RoleType::Enum role)
Definition: associationwidget.cpp:1091
bool isActivated() const
Definition: associationwidget.cpp:1749
void slotClassifierListItemRemoved(UMLClassifierListItem *obj)
Definition: associationwidget.cpp:3875
virtual void setUMLObject(UMLObject *obj)
Definition: associationwidget.cpp:215
QPointF m_oldNamePoint
Position of name floatingtext saved by saveIdealTextPositions()
Definition: associationwidget.h:280
FloatingTextWidget * roleWidget(Uml::RoleType::Enum role) const
Definition: associationwidget.cpp:822
Uml::Changeability::Enum changeability(Uml::RoleType::Enum role) const
Definition: associationwidget.cpp:1120
AssociationWidgetList m_ordered
auxiliary variable for updateAssociations()
Definition: associationwidget.h:267
void setName(const QString &strRole)
Definition: associationwidget.cpp:880
int m_unNameLineSegment
Definition: associationwidget.h:278
bool isLayoutChangeable()
Definition: associationwidget.cpp:1322
ClassifierWidget * m_associationClass
used if we have an assoc. class
Definition: associationwidget.h:294
virtual QPainterPath shape() const
Definition: associationwidget.cpp:3863
void setChangeWidget(const QString &strChangeWidget, Uml::RoleType::Enum role)
Definition: associationwidget.cpp:1147
virtual void calculateNameTextSegment()
Definition: associationwidget.cpp:479
void setFloatingText(Uml::TextRole::Enum role, const QString &text, FloatingTextWidget *&ft)
Definition: associationwidget.cpp:1018
virtual void hoverMoveEvent(QGraphicsSceneHoverEvent *event)
Definition: associationwidget.cpp:3959
void moveEvent(QGraphicsSceneMouseEvent *me)
Definition: associationwidget.cpp:1530
void widgetMoved(UMLWidget *widget, qreal x, qreal y)
Definition: associationwidget.cpp:1866
virtual void mouseReleaseEvent(QGraphicsSceneMouseEvent *event)
Definition: associationwidget.cpp:2914
bool isSelf() const
Definition: associationwidget.cpp:1390
Uml::ID::Type widgetIDForRole(Uml::RoleType::Enum role) const
Definition: associationwidget.cpp:1449
int m_nLinePathSegmentIndex
anchor for m_pAssocClassLine
Definition: associationwidget.h:288
QGraphicsRectItem * m_pAssocClassLineSel1
selection decoration for the end point of the assoc. class line
Definition: associationwidget.h:291
FloatingTextWidget * textWidgetByRole(Uml::TextRole::Enum tr) const
Definition: associationwidget.cpp:840
QPointF m_oldRoleBPoint
Position of role B name floatingtext saved by saveIdealTextPositions()
Definition: associationwidget.h:286
virtual QString lwOperationText()
Definition: associationwidget.cpp:435
bool checkRemovePoint(const QPointF &scenePos)
Definition: associationwidget.cpp:3225
void setChangeability(Uml::Changeability::Enum value, Uml::RoleType::Enum role)
Definition: associationwidget.cpp:1131
QPointF m_oldMultiAPoint
Position of role A multiplicity floatingtext saved by saveIdealTextPositions()
Definition: associationwidget.h:281
QString multiplicity(Uml::RoleType::Enum role) const
Definition: associationwidget.cpp:1053
Uml::TextRole::Enum calculateNameType(Uml::TextRole::Enum defaultRoleType)
Definition: associationwidget.cpp:1206
virtual void contextMenuEvent(QGraphicsSceneContextMenuEvent *event)
Definition: associationwidget.cpp:3915
virtual void mouseMoveEvent(QGraphicsSceneMouseEvent *event)
Definition: associationwidget.cpp:3267
virtual ~AssociationWidget()
Definition: associationwidget.cpp:204
virtual void setTextColor(const QColor &color)
Definition: associationwidget.cpp:3134
void insertIntoLists(qreal position, const AssociationWidget *assoc)
Definition: associationwidget.cpp:3439
void updatePointsException()
Definition: associationwidget.cpp:2021
virtual void setCustomOpText(const QString &opText)
Definition: associationwidget.cpp:330
virtual bool activate(IDChangeLog *changeLog=0)
Definition: associationwidget.cpp:667
Common implementation for class widget and interface widget.
Definition: classifierwidget.h:28
Displays a line of text or an operation.
Definition: floatingtextwidget.h:32
Definition: idchangelog.h:22
Interface to FloatingTextWidget for AssociationWidget and MessageWidget.
Definition: linkwidget.h:32
Sets up association information.
Definition: association.h:29
Sets up attribute information.
Definition: attribute.h:23
A base class for classifier list items (e.g. attributes)
Definition: classifierlistitem.h:25
Information for a non-graphical Concept/Class.
Definition: classifier.h:35
The base class for UML objects.
Definition: umlobject.h:70
Definition: operation.h:20
Definition: umlscene.h:65
The base class for graphical UML objects.
Definition: umlwidget.h:36
Common base class for UMLWidget and AssociationWidget.
Definition: widgetbase.h:101
QRectF rect() const
Definition: widgetbase.cpp:835
int x
Definition: cxx11-lambda-functions-and-expressions.h:4
QList< QPointer< MessageWidget > > MessageWidgetList
Definition: messagewidgetlist.h:13
QString newText(UMLObject::ObjectType type)
Definition: model_utils.cpp:619
Enum
Definition: basictypes.h:92
Enum
Definition: basictypes.h:202
std::string Type
Definition: basictypes.h:371
Enum
Definition: basictypes.h:330
Enum
Definition: basictypes.h:236
Enum
Definition: basictypes.h:176
Enum
Definition: basictypes.h:45
QList< QPointer< UMLWidget > > UMLWidgetList
Definition: umlwidgetlist.h:13