summaryrefslogtreecommitdiffstats
path: root/src/cnitem.h
diff options
context:
space:
mode:
authortpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2010-02-24 01:49:02 +0000
committertpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2010-02-24 01:49:02 +0000
commit5de3dd4762ca33a0f92e79ffa4fe2ff67069d531 (patch)
treebad482b7afa4cdf47422d60a5dd2c61c7e333b09 /src/cnitem.h
downloadktechlab-5de3dd4762ca33a0f92e79ffa4fe2ff67069d531.tar.gz
ktechlab-5de3dd4762ca33a0f92e79ffa4fe2ff67069d531.zip
Added KDE3 version of ktechlab
git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/ktechlab@1095338 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'src/cnitem.h')
-rw-r--r--src/cnitem.h191
1 files changed, 191 insertions, 0 deletions
diff --git a/src/cnitem.h b/src/cnitem.h
new file mode 100644
index 0000000..7a5f55a
--- /dev/null
+++ b/src/cnitem.h
@@ -0,0 +1,191 @@
+/***************************************************************************
+ * Copyright (C) 2003-2005 by David Saxton *
+ * david@bluehaze.org *
+ * *
+ * 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
+