NetworkHandle.h

Go to the documentation of this file.

/****************************************************************************

Copyright (c) 2008 Deepak Chandran
Contact: Deepak Chandran (dchandran1@gmail.com)
See COPYRIGHT.TXT

A class that is used to store a network. The network is a collection of Item Handles. 
The history stack is also a key component of a network.

A class that is used to store a network. The network is a collection of Item Handles. 
The history stack is also a key component of a network.
The network can either be represented as text using TextEditor or visualized with graphical items in the
GraphicsScene. Each node and connection are contained in a handle, and each handle can either be represented as text or as graphics.
The two main components of NetworkWindow are the SymbolsTable and HistoryStack
This class provides functions for inserting items, removing items, and changing information inside the model.

****************************************************************************/

#ifndef TINKERCELL_CORENETWORKHANDLE_H
#define TINKERCELL_CORENETWORKHANDLE_H

#include <stdlib.h>
#include <QtGui>
#include <QObject>
#include <QString>
#include <QRegExp>
#include <QHash>
#include <QUndoCommand>
#include <QToolBar>

#include "DataTable.h"
#include "HistoryWindow.h"
#include "SymbolsTable.h"
#include "NetworkWindow.h"

namespace Tinkercell
{
        class ItemHandle;
        class ItemData;
        class MainWindow;
        class NetworkWindow;
        class ConsoleWindow;
        
        class TINKERCELLCOREEXPORT NetworkHandle : public QObject
        {
                Q_OBJECT

        private:
                MainWindow * mainWindow;
                QList<NetworkWindow*> networkWindows;
                
        public:
                QUndoStack history;
                SymbolsTable symbolsTable;
                
                NetworkHandle(MainWindow *);
                virtual ~NetworkHandle();
                
                virtual QList<ItemHandle*> handles(bool sort=false) const;
                virtual QList<ItemHandle*> handlesSortedByFamily() const;
                virtual ItemHandle* globalHandle();
                virtual QString annotations() const;

                virtual GraphicsScene * currentScene() const;
                virtual TextEditor * currentTextEditor() const;
                virtual NetworkWindow * currentWindow() const;
                virtual void showScene(GraphicsScene *);
                virtual void showTextEditor(TextEditor *);
                ConsoleWindow * console() const;

                QList<ItemHandle*> findItem(const QString&) const;
                QList<ItemHandle*> findItem(const QRegExp&) const;
                QList<ItemHandle*> findItem(const QStringList&) const;
                QList< QPair<ItemHandle*,QString> > findData(const QString&) const;
                QList< QPair<ItemHandle*,QString> > findData(const QStringList&) const;
                QList< QPair<ItemHandle*,QString> > findData(const QRegExp&) const;
                virtual void remove(const QString& name, const QList<QGraphicsItem*>& items);
                virtual void remove(const QString& name, const QList<ItemHandle*>& items);
                virtual QList<GraphicsScene*> scenes() const;
                virtual QList<TextEditor*> editors() const;
                virtual GraphicsScene * createScene(const QList<QGraphicsItem*>& insertItems = QList<QGraphicsItem*>());
                virtual GraphicsScene * createScene(ItemHandle *, const QRectF& boundingRect=QRectF());
                virtual TextEditor * createTextEditor(const QString& text = QString());
                virtual void setWindowTitle(const QString&);
                virtual QString windowTitle() const;
                virtual bool parseMath(QString&,QStringList&,QStringList&,QList<ItemHandle*>&);
                virtual QString makeUnique(const QString&, const QStringList& doNotUseNames=QStringList()) const;
                virtual QString makeUnique(ItemHandle * handle, const QStringList& doNotUseNames=QStringList()) const;
                virtual QStringList makeUnique(const QStringList&, const QStringList& doNotUseNames=QStringList()) const;
                virtual QString rename(const QString& oldname, const QString& new_name);
                virtual QString rename(ItemHandle * item, const QString& new_name);
                virtual QStringList rename(const QList<ItemHandle*>& items, const QList<QString>& new_names);

                virtual void setParentHandle(const QList<ItemHandle*>& handles, const QList<ItemHandle*>& parentHandles);
                virtual void setParentHandle(ItemHandle * child, ItemHandle * parent);
                virtual void setParentHandle(const QList<ItemHandle*> children, ItemHandle * parent);
                
                virtual void setHandleFamily(const QList<ItemHandle*>& handles, const QList<ItemFamily*>& newfamilies);
                virtual void setHandleFamily(ItemHandle * handle, ItemFamily * newfamily);
                virtual void setHandleFamily(const QList<ItemHandle*> handles, ItemFamily * newfamily);

                virtual void changeData(const QString& name, ItemHandle* handle, const QString& hashstring, const NumericalDataTable* newdata);
                virtual void changeData(const QString& name, const QList<ItemHandle*>& handles, const QList<QString>& hashstring, const QList<NumericalDataTable*>& newdata);
                virtual void changeData(const QString& name, const QList<ItemHandle*>& handles, const QString& hashstring, const QList<NumericalDataTable*>& newdata);
                virtual void changeData(const QString& name, ItemHandle* handle, const QString& hashstring, const TextDataTable* newdata);
                virtual void changeData(const QString& name, const QList<ItemHandle*>& handles, const QList<QString>& hashstring, const QList<TextDataTable*>& newdata);
                virtual void changeData(const QString& name, const QList<ItemHandle*>& handles, const QString& hashstring, const QList<TextDataTable*>& newdata);
                virtual void changeData(const QString& name, ItemHandle* handle, const QString& hashstring, const NumericalDataTable* newdata1, const TextDataTable* newdata2);
                virtual void changeData(const QString& name, const QList<ItemHandle*>& handles, const QList<QString>& hashstring, const QList<NumericalDataTable*>& newdata1, const QList<TextDataTable*>& newdata2);
                virtual void changeData(const QString& name, const QList<ItemHandle*>& handles, const QString& hashstring, const QList<NumericalDataTable*>& newdata1, const QList<TextDataTable*>& newdata2);
                virtual void changeData(const QString& name, const QList<ItemHandle*>& handles, const QList<NumericalDataTable*>& olddata1, const QList<NumericalDataTable*>& newdata1);
                virtual void changeData(const QString& name, const QList<ItemHandle*>& handles, const QList<TextDataTable*>& olddata2, const QList<TextDataTable*>& newdata2);
                virtual void changeData(const QString& name, const QList<ItemHandle*>& handles, const QList<NumericalDataTable*>& olddata1, const QList<NumericalDataTable*>& newdata1, const QList<TextDataTable*>& olddata2, const QList<TextDataTable*>& newdata2);
                virtual void changeData(const QString& name, const QList<ItemHandle*>& handles, NumericalDataTable* olddata1, const NumericalDataTable* newdata1, TextDataTable* olddata2, const TextDataTable* newdata2);
                virtual void changeData(const QString& name, const QList<ItemHandle*>& handles, NumericalDataTable* olddata1, const NumericalDataTable* newdata1);
                virtual void changeData(const QString& name, const QList<ItemHandle*>& handles, TextDataTable* olddata1, const TextDataTable* newdata1);
                virtual void assignHandles(const QList<QGraphicsItem*>& items, ItemHandle* newHandle);
                virtual void mergeHandles(const QList<ItemHandle*>& handles);
                virtual void setModelValues(const QStringList& names, const QList<double>& values, int column=0, const QString& defaultDataTable=QString());
                virtual void setModelValues(const QStringList& names, const QStringList& values, int column=0, const QString& defaultDataTable=QString());
                virtual void setModelValues(const NumericalDataTable& newvalues, const QString& defaultDataTable=QString());
                virtual void setModelValues(const TextDataTable& newvalues, const QString& defaultDataTable=QString());
        public slots:
                virtual void updateSymbolsTable();
                virtual void updateSymbolsTable(int);
                virtual void close();
                virtual void undo();
                virtual void redo();
                virtual void push(QUndoCommand*);

        signals:

                void itemsRenamed(NetworkHandle * network, const QList<ItemHandle*>& items, const QList<QString>& oldnames, const QList<QString>& newnames);
                
                void parentHandleChanged(NetworkHandle * network, const QList<ItemHandle*>&, const QList<ItemHandle*>&);
                
                void handleFamilyChanged(NetworkHandle * network, const QList<ItemHandle*>&, const QList<ItemFamily*>&);
                
                void dataChanged(const QList<ItemHandle*>& items);
                
                void handlesChanged(NetworkHandle * network, const QList<QGraphicsItem*>& items, const QList<ItemHandle*>& old);

                void historyChanged(int i=0);
                
        private:
        
                void emitHistoryChanged(int i=0);

                friend class GraphicsView;
                friend class GraphicsScene;
                friend class TextEditor;
                friend class MainWindow;
                friend class NetworkWindow;
                friend class SymbolsTable;
        };

}

#endif