1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
/* This file is part of the KDE project
* Copyright (C) 2007 Boudewijn Rempt <boud@kde.org>
* Copyright (C) 2007 Thorsten Zachmann <zachmann@kde.org>
* Copyright (C) 2007 Jan Hambrecht <jaham@gmx.net>
* Copyright (C) 2009 Thomas Zander <zander@kde.org>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public License
* along with this library; see the file COPYING.LIB. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef KO_CONNECTION_SHAPE_H
#define KO_CONNECTION_SHAPE_H
#include "KoParameterShape.h"
#include "flake_export.h"
#define KOCONNECTIONSHAPEID "KoConnectionShape"
class KoConnectionShapePrivate;
/// API docs go here
class FLAKE_EXPORT KoConnectionShape : public KoParameterShape
{
public:
enum Type {
Standard, ///< escapes connected shapes with straight lines, connects with perpendicular lines
Lines, ///< escapes connected shapes with straight lines, connects with straight line
Straight, ///< one straight line between connected shapes
Curve ///< a single curved line between connected shapes
};
// IDs of the connecting handles
enum HandleId {
StartHandle,
EndHandle
};
KoConnectionShape();
virtual ~KoConnectionShape();
// reimplemented
virtual void saveOdf(KoShapeSavingContext &context) const;
// reimplemented
virtual bool loadOdf(const KoXmlElement &element, KoShapeLoadingContext &context);
// reimplemented
virtual QString pathShapeId() const;
/**
* Sets the first shape this connector is connected to
*
* Passing a null pointer as the first parameter will sever the connection.
*
* @param shape the shape to connect to or null to reset the connection
* @param connectionPointId the id of the connection point to connect to
* @return true if connection could be established, otherwise false
*/
bool connectFirst(KoShape *shape, int connectionPointId);
/**
* Sets the second shape the connector is connected to
*
* Passing a null pointer as the first parameter will sever the connection.
*
* @param shape the shape to connect to or null to reset the connection
* @param connectionPointId the id of the connection point to connect to
* @return true if connection could be established, otherwise false
*/
bool connectSecond(KoShape *shape, int connectionPointId);
/**
* Return the first shape this connection is attached to, or null if none.
*/
KoShape *firstShape() const;
/**
* Return the connection point id of the first shape we are connected to.
* In case we are not connected to a first shape the return value is undefined.
* @see firstShape(), KoShape::connectionPoints()
*/
int firstConnectionId() const;
/**
* Return the second shape this connection is attached to, or null if none.
*/
KoShape *secondShape() const;
/**
* Return the connection point id of the second shape we are connected to.
* In case we are not connected to a second shape the return value is undefined.
* @see firstShape(), KoShape::connectionPoints()
*/
int secondConnectionId() const;
/**
* Finishes the loading of a connection.
*/
void finishLoadingConnection();
/// Returns connection type
Type type() const;
/// Sets the connection type
void setType(Type connectionType);
/// Updates connections to shapes
void updateConnections();
protected:
/// reimplemented
void moveHandleAction(int handleId, const QPointF &point, Qt::KeyboardModifiers modifiers = Qt::NoModifier);
/// reimplemented
void updatePath(const QSizeF &size);
/// reimplemented
virtual void shapeChanged(ChangeType type, KoShape *shape);
private:
Q_DECLARE_PRIVATE(KoConnectionShape)
};
#endif
|
