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
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
|
/***************************************************************************
* Copyright (C) 2003-2005 by David Saxton *
* [email protected] *
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
***************************************************************************/
#ifndef CNITEM_H
#define CNITEM_H
#include "item.h"
#include "ciwidgetmgr.h"
class Button;
class CNItem;
class ICNDocument;
class Connector;
class DoubleSpinBox;
class LibraryItem;
class Node;
class QSlider;
class QString;
class QToolButton;
class QWMatrix;
class Slider;
class Text;
class NodeInfo
{
public:
NodeInfo();
QString id; // External id (ICNDocument scope)
Node *node; //Pointer to the node
double x; // X position relative to item
double y; // Y position relative to item
int orientation; // Orientation relative to item
};
typedef QMap<QString, QString> StringMap;
typedef QMap<QString, NodeInfo> NodeMap; // Internal id, node info
typedef QValueList<QGuardedPtr<Connector> > ConnectorList;
typedef QMap<QString, QGuardedPtr<Text> > TextMap;
/**
Essentially, all items that live on ICNDocument should inherit from this class.
This class provides much functionality (moving items, creation of associated nodes,
saving and editing of associated data, cutting / copying, etc)
@short Base class for all components/flowparts/etc
@author Daniel Clarke
@author David Saxton
*/
class CNItem : public Item, public CIWidgetMgr
{
Q_OBJECT
public:
CNItem( ICNDocument *_icnView, bool newItem, const QString &id );
virtual ~CNItem();
/**
* Returns the run-time identifier for the CNItem - ItemDocument::RTTI::CNItem
*/
int rtti() const;
/**
* Creates a node which is attached to the item. The node will be moved
* about with the item, and destroyed along with the item. The position
* coordinates of the node are relative to the upper left corner of the item.
* @param type See Node::node_type
*/
Node* createNode( double _x, double _y, int orientation, const QString &name, uint type );
/**
* Removes a child node. You should use this function if you want to remove
* any nodes during the lifetime of the CNItem.
*/
bool removeNode( const QString &name );
/**
* Sets the mouse click point when moving this item
*/
void setInitialPos( const QPoint &pos );
/**
* Snaps the component to the grid.
*/
void snap( int newx = -1, int newy = -1 );
/**
* Returns the closest node that is associated with the CNItem
*/
Node *getClosestNode( const QPoint &pos );
/**
* Returns a list of connectors associated with the CNItem
*/
ConnectorList connectorList();
virtual bool preResize( QRect sizeRect );
virtual bool mousePressEvent( const EventInfo &eventInfo );
virtual bool mouseReleaseEvent( const EventInfo &eventInfo );
virtual bool mouseDoubleClickEvent ( const EventInfo &eventInfo );
virtual bool mouseMoveEvent( const EventInfo &eventInfo );
virtual bool wheelEvent( const EventInfo &eventInfo );
virtual void enterEvent();
virtual void leaveEvent();
/**
* ICNDocument needs to know what 'cells' a CNItem is present in,
* so that connection mapping can be done to avoid CNItems.
* This function will add the hit penalty to the cells pointed to
* by ICNDocument::cells()
*/
virtual void updateConnectorPoints( bool add );
/**
* Converts the id used to internally identify a node to the global
* ICNDocument node id. eg "vss" might return "node__13".
*/
QString nodeId( const QString &internalNodeId );
/**
* Returns a pointer to the node with the given internal (child) id
*/
Node *childNode( const QString &childId );
/**
* Returns the node map used:
* QMap<QString, NodeInfo> NodeMap
* It's probably best to cache this data
*/
NodeMap nodeMap() const { return m_nodeMap; }
/**
* Returns the TextMap used for canvas text
*/
TextMap textMap() const { return m_textMap; }
virtual void setVisible( bool yes );
virtual void updateZ( int baseZ );
virtual ItemData itemData() const;
virtual void restoreFromItemData( const ItemData &itemData );
virtual void updateNodeLevels();
public slots:
/**
* Moves item - use this instead of moveBy() so that associated Nodes also get moved
*/
virtual void moveBy( double dx, double dy );
/**
* Remove the item and associated nodes. It appends the item to the
* ICNDocument's delete list, so you must call ICNDocument::flushDeleteList()
* after calling this (and possible ICNDocument::clearDeleteList() befor
* calling it) The virtual function void handleRemove() is called to allow
* any child classes to clear up any neccessary data (which doesn't do
* anything by default), before CNItem does the rest
*/
virtual void removeItem();
/**
* This item has been resized, so update the nodes relative positions
*/
virtual void updateAttachedPositioning();
protected:
virtual void reparented( Item *oldParent, Item *newParent );
virtual void drawShape( QPainter &p );
virtual void postResize();
/**
* CNItem handles drawing of text associated with the CNItem.
* @param id is a unique identifier that can be used to change the text displayed.
* @param pos is the position that the text occupies relative to the top left corner of the CNItem.
* @param display is the actual text to be displayed.
* @param internal is used to determine the z-level of the text - whether it should be below or above the item
* @param flags Text alignment flags - Qt::AlignmentFlags and Qt::TextFlags OR'd together.
*/
Text* addDisplayText( const QString &id, const QRect & pos, const QString &display, bool internal = true, int flags = Qt::AlignHCenter | Qt::AlignVCenter );
void setDisplayText( const QString &id, const QString &display );
/**
* Remove the display text with the given id
*/
void removeDisplayText( const QString &id );
/**
* Sets the right colour if selected, transforms the matrix of the painter
*/
virtual void initPainter( QPainter &p );
QPoint m_offset;
QGuardedPtr<ICNDocument> p_icnDocument;
TextMap m_textMap;
NodeMap m_nodeMap;
QColor m_selectedCol;
QColor m_brushCol;
bool b_pointsAdded;
};
typedef QValueList<CNItem*> CNItemList;
#endif
|
