/***************************************************************************
* *
* 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 MYLISTVIEW_H
#define MYLISTVIEW_H
#include
#include
#include "umldoc.h"
#include "listpopupmenu.h"
#include
#include "mylistviewitem.h"
#include "mylistviewitemlist.h"
/**
* This is one of the main classes used in this program.
* Information is displayed here in a tree view. No objects are created
* here. A call to @ref UMLDoc make any additions/deletion or updates to
* objects. This class will then wait for a signal before updating the tree view.
*
* @short Displays the list view for the program.
* @author Paul Hensgen
* @version 1.0
*/
class IDChangeLog;
class MyListView : public KListView {
Q_OBJECT
friend class UMLClipboard;
public:
enum Icon_Type
{
it_Home = 0,
it_Folder_Green,
it_Folder_Green_Open,
it_Folder_Grey,
it_Folder_Grey_Open,
it_Diagram, //change to have different one for each type of diagram
it_Class,
it_Actor,
it_UseCase,
it_Public_Method,
it_Private_Method,
it_Protected_Method,
it_Public_Attribute,
it_Private_Attribute,
it_Protected_Attribute
};
/**
* Constructs the tree view.
*
* @param parent The parent to this.
* @param name The internal name for this class.
*/
MyListView(QWidget *parent,const char *name);
/**
* Standard deconstructor.
*/
~MyListView();
/**
* Sets the document his is associated with. This is important as
* this is required as to setup the callbacks.
*
* @param d The document to associate with this class.
*/
void setDocument(UMLDoc * d);
/**
* Carries out initalisation of attributes in class.
*/
void init();
/**
* Set the current view to the given view.
*
* @param v The current view.
*/
void setView(UMLView * v);
/**
* Use to save or load this classes information
*
* @param s Pointer to the datastream (file) to save/load from.
* @param archive If true will save the classes information, else will
* load the information.
*
* @return Returns the status of the operation.
*/
bool serialize(QDataStream *s, bool archive);
bool ReadChilds( MyListViewItem* parent, QDataStream *s);
long getClipSizeOf();
void setLoading(bool _state) {
loading = _state;
}
void setWidgetDefaults();
bool GetSelectedItems(MyListViewItemList &ItemList);
/**
* Returns the amount of bytes needed to serialize Item to the clipboard
*/
long getClipSizeOfItemList(MyListViewItemList* Items);
/**
* Serialize Item to a QDataStream that will be put in the clipboard
*/
bool clipSerializeItemList(MyListViewItemList* Items, QDataStream *s, const bool toClip);
/**
* Creates a new MyListViewItem from a MyListViewItemData, if
* parent is null the ListView Decides who is going to be the
* parent
*/
MyListViewItem* CreateItem(MyListViewItemData& Data, IDChangeLog& IDChanges,
MyListViewItem* parent = 0);
/**
* Transalates a QPoint to the coordinates of the viewport
* containing the ListView
*/
QPoint TranslatePosition(QPoint Pt);
/**
* Return the amount of items selected.
*/
int getSelectedCount();
/**
* Returns the correct pixmap for the given type.
*/
QPixmap & getPixmap( Icon_Type type );
/**
* Returns the document pointer. Called by the MyListViewItem class.
*/
UMLDoc * getDocument() {
return doc;
}
/**
* Adds a new item to the tree of the given type under the given parent.
* Method will take care of signalling anyone needed on creation of new item.
* e.g. UMLDoc if an UMLObject is created.
*/
void addNewItem( QListViewItem * parent, Uml::ListView_Type type );
/**
* Creates a UMLObject out of the given list view item.
*/
void createUMLObject( MyListViewItem * item, Uml::UMLObject_Type type );
/**
* Creates a child UMLObject out of the given list view item.
*/
void createChildUMLObject( MyListViewItem * item, Uml::UMLObject_Type type );
/**
* Creates a diagram out of the given list view item.
*/
void createDiagram( MyListViewItem * item, Uml::Diagram_Type type );
/**
* Returns a unique name for a diagram.
*/
QString getUniqueDiagramName( Uml::Diagram_Type type );
/**
* Returns a unique name for a child umlobject.
*/
QString getUniqueChildUMLObjectName( UMLConcept * parent, Uml::UMLObject_Type type );
/**
* Returns a unique name for an object.
*/
QString getUniqueUMLObjectName( Uml::UMLObject_Type type );
/**
* Returns if the given name is unique for the given items type.
*/
bool isUnique( MyListViewItem * item, QString name );
/**
* Cancel rename event has occurred for the given item.
*/
void cancelRename( QListViewItem * item );
bool saveToXMI( QDomDocument & qDoc, QDomElement & qElement );
bool loadFromXMI( QDomElement & element );
bool loadChildrenFromXMI( MyListViewItem * parent, QDomElement & element );
protected:
MyListViewItem * rv;//root view
MyListViewItem * ucv;//use case view item
MyListViewItem * lv;//logical view item
ListPopupMenu * menu;
QString oldText, message;
UMLDoc * doc;
bool loading, m_bStartedCut, m_bIgnoreCancelRename;
struct Pixmaps {
QPixmap Home;
QPixmap Folder_Green;
QPixmap Folder_Green_Open;
QPixmap Folder_Grey;
QPixmap Folder_Grey_Open;
QPixmap Diagram; //change to have different one for each type of diagram
QPixmap Class;
QPixmap Actor;
QPixmap UseCase;
QPixmap Public_Method;
QPixmap Private_Method;
QPixmap Protected_Method;
QPixmap Public_Attribute;
QPixmap Private_Attribute;
QPixmap Protected_Attribute;
}
m_Pixmaps;
void contentsMouseReleaseEvent(QMouseEvent * me);
void contentsMousePressEvent(QMouseEvent *me);
void contentsMouseDoubleClickEvent(QMouseEvent * me);
void focusOutEvent ( QFocusEvent * fe);
bool goodName(QListViewItem *i);
QDragObject* dragObject();
void startDrag();
void tidyChangeItem();
bool acceptDrag (QDropEvent* event) const;
MyListViewItem * findChildUMLObject(UMLObject *c);
MyListViewItem * findUMLObject(UMLObject *p);
MyListViewItem * findView(UMLView *v);
MyListViewItem * findItem(int id);
Uml::ListView_Type convert_DT_LVT(Uml::Diagram_Type dt);
Uml::ListView_Type convert_OT_LVT(Uml::UMLObject_Type ot);
/**
* Loads the pixmaps to use in the list items.
*/
void loadPixmaps();
public slots:
void slotDiagramCreated(int id);
void slotChildObjectCreated(UMLObject * o);
void slotDiagramRenamed(int id);
void slotObjectChanged(UMLObject * o);
void slotChildObjectChanged(UMLObject * o);
void slotObjectRemoved(UMLObject * o);
void slotDiagramRemoved(int id);
void popupMenuSel(int sel);
void slotObjectCreated(UMLObject * o);
void slotDropped(QDropEvent * de, QListViewItem * parent, QListViewItem * item);
void slotExpanded( QListViewItem * item );
void slotCollapsed( QListViewItem * item );
/**
* Connects to the signal that @ref UMLApp emits when a
* cut operation is successful.
*/
void slotCutSuccessful();
/**
* When a user requests a new item we wait for the signal
* to then verify the item. The class only connects to the
* rename signal while needed.
*/
void slotItemRenamed( QListViewItem * item , int col );
signals:
/**
* Reset the status bar
*/
void sigResetStatusbarProgress();
/*
*
* Set the total range of the progressbar
*
* @param totalSteps Total range of the progressbar (0..totalSteps)
*/
void sigSetStatusbarProgressSteps(int totalSteps);
/*
*
* Set the total range of the progressbar
*
* @param totalSteps Total range of the progressbar (0..totalStep
*/
void sigSetStatusbarProgress(int stepPosition);
};
#endif
| Generated by: jr on radge on Wed Sep 25 00:11:47 2002, using kdoc 2.0a54. |