umbrello API Documentation
	Overview Class Hierarchy Classes Classes (annotated) Members Namespaces Source Files

associationwidget.h

/***************************************************************************
 *                                                                         *
 *   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.                                   *
 *                                                                         *
 *   copyright (C) 2002-2006                                               *
 *   Umbrello UML Modeller Authors <uml-devel@uml.sf.net>                  *
 ***************************************************************************/

#ifndef ASSOCIATIONWIDGET_H
#define ASSOCIATIONWIDGET_H

#include "widgetbase.h"
#include "linkwidget.h"
#include "umlwidgetlist.h"
#include "messagewidgetlist.h"
#include "associationwidgetlist.h"
#include "linepath.h"

class IDChangeLog;
class ListPopupMenu;
class QBitmap;
class QPixmap;
class QDataStream;
class QCanvasLine;
class ClassifierWidget;
class UMLDoc;
class UMLView;
class UMLAssociation;
class UMLClassifierListItem;
class UMLAttribute;
class UMLOperation;

class AssociationWidget : public WidgetBase, public LinkWidget {
    Q_OBJECT
public:
    enum Region {
        Error = 0,
        West, North, East, South,
        NorthWest, NorthEast, SouthEast, SouthWest,
        Center
    };

    AssociationWidget(UMLView *view);

    AssociationWidget(UMLView *view, UMLWidget* WidgetA,
                      Uml::Association_Type Type, UMLWidget* WidgetB,
                      UMLAssociation *umlassoc = NULL);

    virtual ~AssociationWidget();

    AssociationWidget& operator=(AssociationWidget & Other);

    bool operator==(AssociationWidget & Other);

    bool operator!=(AssociationWidget & Other);

    bool activate();

    void setWidget(UMLWidget* widget, Uml::Role_Type role);

    FloatingTextWidget* getMultiWidget(Uml::Role_Type role);

    QString getMulti(Uml::Role_Type role) const;

    FloatingTextWidget* getNameWidget();

    QString getName() const;

    FloatingTextWidget* getRoleWidget(Uml::Role_Type role);

    FloatingTextWidget* getTextWidgetByRole(Uml::Text_Role tr);

    QString getRoleName(Uml::Role_Type role) const;

    QString getRoleDoc(Uml::Role_Type role) const;

    void setName (const QString &strRole);

    void setMulti(const QString &strMulti, Uml::Role_Type role);

    Uml::Visibility getVisibility (Uml::Role_Type role) const;

    void setVisibility (Uml::Visibility visibility, Uml::Role_Type role );

    Uml::Changeability_Type getChangeability(Uml::Role_Type role) const;

    void setChangeability (Uml::Changeability_Type value, Uml::Role_Type role);

    Uml::IDType getWidgetID(Uml::Role_Type role) const;

    UMLWidget* getWidget(Uml::Role_Type role);

    bool setWidgets( UMLWidget* widgetA, Uml::Association_Type assocType, UMLWidget* widgetB);

    bool checkAssoc(UMLWidget * widgetA, UMLWidget *widgetB);

    bool contains(UMLWidget* widget);

    bool isCollaboration();

    Uml::Association_Type getAssocType() const;

    void setAssocType(Uml::Association_Type type);

    QString toString();

    bool isActivated();

    void setActivated(bool active /*=true*/);

    void setSelected(bool _select = true);

    bool getSelected() const {
        return m_bSelected;
    }

    LinePath* getLinePath() {
        return &m_LinePath;
    }

    void widgetMoved(UMLWidget* widget, int x, int y);

    void saveIdealTextPositions();

    void calculateNameTextSegment();

    void mouseDoubleClickEvent(QMouseEvent * me);

    void mousePressEvent(QMouseEvent * me);

    void mouseReleaseEvent(QMouseEvent * me);

    void mouseMoveEvent(QMouseEvent * me);

    bool onAssociation(const QPoint & point);

    bool onAssocClassLine(const QPoint & point);

    void createAssocClassLine();

    void createAssocClassLine(ClassifierWidget* classifierWidget,
                              int linePathSegmentIndex);

    void selectAssocClassLine(bool sel = true);

    void moveMidPointsBy( int x, int y );

    void moveEntireAssoc( int x, int y );

    QRect getAssocLineRectangle();

    QFont getFont () const;

    void setLineColor(const QColor &colour);

    void setLineWidth(uint width);

    void lwSetFont (QFont font);

    FloatingTextWidget* getChangeWidget(Uml::Role_Type role);

    void setRoleName(const QString &strRole, Uml::Role_Type role);

    void setRoleDoc(const QString &doc, Uml::Role_Type role);

    UMLClassifier *getOperationOwner();

    UMLOperation *getOperation();

    void setOperation(UMLOperation *op);

    QString getCustomOpText();

    void setCustomOpText(const QString &opText);

    void setMessageText(FloatingTextWidget *ft);

    UMLAssociation * getAssociation() const;

    UMLAttribute * getAttribute() const;

    void setText(FloatingTextWidget *ft, const QString &text);

    void resetTextPositions();

    void constrainTextPos(int &textX, int &textY, int textWidth, int textHeight,
                          Uml::Text_Role tr);

    bool showDialog();

    void setIndex(int index, Uml::Role_Type role);

    int getIndex(Uml::Role_Type role) const;

    void setTotalCount(int count, Uml::Role_Type role);

    int getTotalCount(Uml::Role_Type role) const;

    void setTotalCount(int count);

    void setSeqNumAndOp(const QString &seqNum, const QString &op);

    UMLClassifier * getSeqNumAndOp(QString& seqNum, QString& op);

    void calculateEndingPoints();

    void removeAssocClassLine();

    void computeAssocClassLine();

    void setUMLObject(UMLObject *obj);

    void saveToXMI( QDomDocument & qDoc, QDomElement & qElement );

    bool loadFromXMI( QDomElement & qElement );

    bool loadFromXMI( QDomElement & qElement, const UMLWidgetList& widgets,
                      const MessageWidgetList* pMessages = NULL);

    void cleanup();

private:

    void setUMLAssociation (UMLAssociation * assoc);

    void mergeAssociationDataIntoUMLRepresentation();

    static Region findPointRegion(QRect Rect, int PosX, int PosY);

    static int findInterceptOnEdge(const QRect &rect, Region region, const QPoint &point);

    static QPoint findIntercept(const QRect &rect, const QPoint &point);

    void moveEvent(QMoveEvent *me);

    Uml::Text_Role CalculateNameType(Uml::Text_Role defaultRoleType);

    bool isPointInsideBoundaries(int PosX, int PosY, QPoint & SPoint,
                                 uint & StartSegmentIndex, uint & EndSegmentIndex);

    static QPoint swapXY(const QPoint &p);

    float totalLength();

    static QPoint calculatePointAtDistance(const QPoint &P1, const QPoint &P2, float Distance);

    static QPoint calculatePointAtDistanceOnPerpendicular(const QPoint &P1, const QPoint &P2, float Distance);

    static float perpendicularProjection(QPoint P1, QPoint P2, QPoint P3, QPoint& ResultingPoint);

    static QPoint midPoint(QPoint p0, QPoint p1);

    QPoint calculateTextPosition(Uml::Text_Role role);

    void setTextPosition(Uml::Text_Role role);

    void setTextPositionRelatively(Uml::Text_Role role, const QPoint &oldPosition);

    Region getWidgetRegion(AssociationWidget * widget) const;

    FloatingTextWidget* m_pName;

    struct WidgetRole {

        FloatingTextWidget* m_pMulti;

        FloatingTextWidget* m_pChangeWidget;

        FloatingTextWidget* m_pRole;

        UMLWidget* m_pWidget;

        QPoint m_OldCorner;

        Region m_WidgetRegion;

        int m_nIndex;

        int m_nTotalCount;

        // The following items are only used if m_pObject is not set.
        Uml::Visibility m_Visibility;
        Uml::Changeability_Type m_Changeability;
        QString m_RoleDoc;

    } m_role[2];

    void setFloatingText(Uml::Text_Role tr, const QString &text, FloatingTextWidget* &ft);

    void updateRegionLineCount(int index, int totalCount,
                               AssociationWidget::Region region, Uml::Role_Type role);

    void updateAssociations(int totalCount, Region region, Uml::Role_Type role);

    int getRegionCount(Region region, Uml::Role_Type role);

    void init (UMLView *view);

    void doUpdates(int otherX, int otherY, Uml::Role_Type role);

    void setChangeWidget(const QString &strChangeWidget, Uml::Role_Type role);

    void checkPoints(const QPoint &p);

    bool linePathStartsAt(const UMLWidget* widget);

    void insertIntoLists(int position, const AssociationWidget* assoc);

    int m_positions[100];             
    int m_positions_len;              
    AssociationWidgetList m_ordered;  

    bool m_bActivated;

    uint                m_unNameLineSegment;
    UMLDoc * m_umldoc;  
    ListPopupMenu       *m_pMenu;
    bool                m_bSelected;
    int                 m_nMovingPoint;

    QPoint m_oldNamePoint;
    QPoint m_oldMultiAPoint;
    QPoint m_oldMultiBPoint;
    QPoint m_oldChangeAPoint;
    QPoint m_oldChangeBPoint;
    QPoint m_oldRoleAPoint;
    QPoint m_oldRoleBPoint;

    int         m_nLinePathSegmentIndex; 
    QCanvasLine *m_pAssocClassLine;  

    QCanvasRectangle *m_pAssocClassLineSel0, *m_pAssocClassLineSel1;

    ClassifierWidget *m_pAssocClassWidget;  

    LinePath m_LinePath;

    // The following items are only used if m_pObject is not set.
    Uml::Association_Type m_AssocType;

public slots:
    void slotMenuSelection(int sel);

    void slotRemovePopupMenu();

    void slotClearAllSelected();

    void slotAttributeRemoved(UMLClassifierListItem* obj);

    void syncToModel();
};
#endif

This file is part of the documentation for umbrello Version 3.1.0.

Documentation copyright © 1996-2004 the KDE developers.
Generated on Tue Jun 26 08:07:54 2007 by doxygen 1.4.1 written by Dimitri van Heesch, © 1997-2003