mirror of
https://github.com/qelectrotech/qelectrotech-source-mirror.git
synced 2025-09-13 20:23:04 +02:00
819c6c6f86
git-svn-id: svn+ssh://svn.tuxfamily.org/svnroot/qet/qet/trunk@5281 bfdf4180-ca20-0410-9c96-a3a8aa849046
265 lines
9.0 KiB
C++
265 lines
9.0 KiB
C++
/*
|
|
Copyright 2006-2017 The QElectroTech Team
|
|
This file is part of QElectroTech.
|
|
|
|
QElectroTech 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.
|
|
|
|
QElectroTech is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with QElectroTech. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
#ifndef ELEMENT_H
|
|
#define ELEMENT_H
|
|
|
|
#include "qet.h"
|
|
#include "qetgraphicsitem.h"
|
|
#include "diagramcontext.h"
|
|
#include "assignvariables.h"
|
|
#include <algorithm>
|
|
|
|
class QETProject;
|
|
class Terminal;
|
|
class Conductor;
|
|
class NumerotationContext;
|
|
class DiagramTextItem;
|
|
class DynamicElementTextItem;
|
|
class ElementTextItemGroup;
|
|
|
|
/**
|
|
This is the base class for electrical elements.
|
|
*/
|
|
class Element : public QetGraphicsItem
|
|
{
|
|
friend class DiagramEventAddElement;
|
|
|
|
Q_OBJECT
|
|
|
|
// constructors, destructor
|
|
public:
|
|
Element(QGraphicsItem * = nullptr);
|
|
~Element() override;
|
|
private:
|
|
Element(const Element &);
|
|
|
|
// attributes
|
|
public:
|
|
/**
|
|
* Enable the use of qgraphicsitem_cast to safely cast a QGraphicsItem into an Element.
|
|
* @return the QGraphicsItem type
|
|
*/
|
|
enum { Type = UserType + 1000 };
|
|
int type() const override { return Type; }
|
|
|
|
/**
|
|
* @brief The kind enum
|
|
* Used to know the kind of this element (master, slave, report ect...)
|
|
*/
|
|
enum kind {Simple = 1,
|
|
NextReport = 2,
|
|
PreviousReport = 4,
|
|
AllReport = 6,
|
|
Master = 8,
|
|
Slave = 16,
|
|
Terminale = 32};
|
|
|
|
private:
|
|
QSize dimensions;
|
|
QPoint hotspot_coord;
|
|
QPixmap preview;
|
|
|
|
// methods
|
|
public:
|
|
/// @return the list of terminals for this element
|
|
virtual QList<Terminal *> terminals() const = 0;
|
|
/// @return the list of conductors attached to this element
|
|
virtual QList<Conductor *> conductors() const = 0;
|
|
/// @return the list of lines items in this element
|
|
virtual QList<QLineF *> lines() const = 0;
|
|
/// @return the list of rectangles items in this element
|
|
virtual QList<QRectF *> rectangles() const = 0;
|
|
/// @return the list of bounding rectangles for circles items in this element
|
|
virtual QList<QRectF *> circles() const = 0;
|
|
/// @return the list of polygons in this element
|
|
virtual QList<QVector<QPointF> *> polygons() const = 0;
|
|
/// @return the list of arcs in this element
|
|
virtual QList<QVector<qreal> *> arcs() const = 0;
|
|
|
|
QList <QPair <Terminal *, Terminal *> > AlignedFreeTerminals () const;
|
|
|
|
/**
|
|
*related method and attributes,
|
|
*about none graphic thing
|
|
*like the linked element or information about this element
|
|
*/
|
|
//METHODS related to linked element
|
|
public:
|
|
bool isFree () const;
|
|
virtual void linkToElement (Element *) {}
|
|
virtual void unlinkAllElements () {}
|
|
virtual void unlinkElement (Element *) {}
|
|
virtual void initLink (QETProject *);
|
|
QList<Element *> linkedElements ();
|
|
virtual kind linkType() const {return m_link_type;} // @return the linkable type
|
|
void newUuid() {uuid_ = QUuid::createUuid();} //create new uuid for this element
|
|
|
|
//ATTRIBUTES related to linked element
|
|
protected:
|
|
QList <Element *> connected_elements;
|
|
QList <QUuid> tmp_uuids_link;
|
|
QUuid uuid_;
|
|
kind m_link_type;
|
|
|
|
signals:
|
|
void linkedElementChanged(); //This signal is emited when the linked elements with this element change
|
|
void elementInfoChange(DiagramContext old_info, DiagramContext new_info);
|
|
void textAdded(DynamicElementTextItem *deti);
|
|
void textRemoved(DynamicElementTextItem *deti);
|
|
void textsGroupAdded(ElementTextItemGroup *group);
|
|
void textsGroupAboutToBeRemoved(ElementTextItemGroup *group);
|
|
void textAddedToGroup(DynamicElementTextItem *text, ElementTextItemGroup *group);
|
|
void textRemovedFromGroup(DynamicElementTextItem *text, ElementTextItemGroup *group);
|
|
|
|
//METHODS related to information
|
|
public:
|
|
DiagramContext elementInformations ()const {return m_element_informations;}
|
|
DiagramContext& rElementInformations () {return m_element_informations;}
|
|
virtual void setElementInformations (DiagramContext dc);
|
|
DiagramContext kindInformations () const {return m_kind_informations;} //@kind_information_ is used to store more information
|
|
//about the herited class like contactelement for know
|
|
// kind of contact (simple tempo) or number of contact show by the element.
|
|
|
|
autonum::sequentialNumbers sequenceStruct () const {return m_autoNum_seq;}
|
|
autonum::sequentialNumbers& rSequenceStruct() {return m_autoNum_seq;}
|
|
|
|
void setUpFormula(bool code_letter = true);
|
|
void setPrefix(QString);
|
|
QString getPrefix() const;
|
|
void freezeLabel(bool freeze);
|
|
bool isFreezeLabel() const {return m_freeze_label;}
|
|
void freezeNewAddedElement();
|
|
|
|
//ATTRIBUTES
|
|
protected:
|
|
DiagramContext m_element_informations, m_kind_informations;
|
|
autonum::sequentialNumbers m_autoNum_seq;
|
|
bool m_freeze_label = false;
|
|
QString m_F_str;
|
|
|
|
public:
|
|
virtual void paint(QPainter *, const QStyleOptionGraphicsItem *) = 0;
|
|
/// @return This element type ID
|
|
virtual QString typeId() const = 0;
|
|
/// @return the human name for this element
|
|
QString name() const override = 0;
|
|
|
|
virtual bool isHighlighted() const;
|
|
virtual void setHighlighted(bool);
|
|
void displayHelpLine(bool b = true);
|
|
void paint(QPainter *, const QStyleOptionGraphicsItem *, QWidget *) override;
|
|
QRectF boundingRect() const override;
|
|
QSize setSize(int, int);
|
|
QSize size() const;
|
|
QPixmap pixmap();
|
|
|
|
// methods related to the hotspot
|
|
QPoint setHotspot(QPoint);
|
|
QPoint hotspot() const;
|
|
|
|
// selection-related methods
|
|
void select();
|
|
void deselect();
|
|
|
|
void editProperty() override;
|
|
|
|
// methods related to XML import/export
|
|
static bool valideXml(QDomElement &);
|
|
virtual bool fromXml(QDomElement &, QHash<int, Terminal *> &, bool = false);
|
|
virtual QDomElement toXml(QDomDocument &, QHash<Terminal *, int> &) const;
|
|
QUuid uuid() const;
|
|
|
|
// orientation-related methods
|
|
int orientation() const;
|
|
|
|
void addDynamicTextItem(DynamicElementTextItem *deti = nullptr);
|
|
void removeDynamicTextItem(DynamicElementTextItem *deti);
|
|
QList<DynamicElementTextItem *> dynamicTextItems() const;
|
|
ElementTextItemGroup *addTextGroup(const QString &name);
|
|
void addTextGroup(ElementTextItemGroup *group);
|
|
void removeTextGroup(ElementTextItemGroup *group);
|
|
ElementTextItemGroup *textGroup(const QString &name) const;
|
|
QList<ElementTextItemGroup *> textGroups() const;
|
|
bool addTextToGroup(DynamicElementTextItem *text, ElementTextItemGroup *group);
|
|
bool removeTextFromGroup(DynamicElementTextItem *text, ElementTextItemGroup *group);
|
|
|
|
protected:
|
|
void drawAxes(QPainter *, const QStyleOptionGraphicsItem *);
|
|
|
|
private:
|
|
bool must_highlight_;
|
|
void drawSelection(QPainter *, const QStyleOptionGraphicsItem *);
|
|
void drawHighlight(QPainter *, const QStyleOptionGraphicsItem *);
|
|
void updatePixmap();
|
|
|
|
protected:
|
|
void mouseMoveEvent ( QGraphicsSceneMouseEvent *event ) override;
|
|
void mouseReleaseEvent ( QGraphicsSceneMouseEvent *event ) override;
|
|
void hoverEnterEvent ( QGraphicsSceneHoverEvent * ) override;
|
|
void hoverLeaveEvent ( QGraphicsSceneHoverEvent * ) override;
|
|
|
|
protected:
|
|
// @m_converted_text_from_description, when a element is created from his description, the old element text item (tagged as 'input' in the xml)
|
|
// are converted to dynamic text field, the QPointF is the original position of the text item, because the origin transformation point of text item
|
|
// and dynamic text item are not the same, so we must to keep a track of this value, to be use in the function element::fromXml
|
|
QHash <DynamicElementTextItem *, QPointF> m_converted_text_from_xml_description;
|
|
private:
|
|
bool m_mouse_over;
|
|
QString m_prefix;
|
|
QList <DynamicElementTextItem *> m_dynamic_text_list;
|
|
QList <ElementTextItemGroup *> m_texts_group;
|
|
|
|
};
|
|
|
|
bool comparPos(const Element * elmt1, const Element * elmt2);
|
|
|
|
inline bool Element::isFree() const {
|
|
return (connected_elements.isEmpty());
|
|
}
|
|
|
|
/**
|
|
Indicate the current orientation of this element
|
|
O = 0°
|
|
1 = 90°
|
|
2 = 180°
|
|
3 = 270°
|
|
@return the current orientation of this element
|
|
*/
|
|
inline int Element::orientation() const {
|
|
return(QET::correctAngle(rotation())/90);
|
|
}
|
|
|
|
/**
|
|
* @brief Element::uuid
|
|
* @return the uuid of this element
|
|
*/
|
|
inline QUuid Element::uuid() const {
|
|
return uuid_;
|
|
}
|
|
|
|
/**
|
|
* @brief Element::linkedElements
|
|
* @return the list of linked elements, the list is sorted by position
|
|
*/
|
|
inline QList <Element *> Element::linkedElements() {
|
|
std::sort(connected_elements.begin(), connected_elements.end(), comparPos);
|
|
return connected_elements;
|
|
}
|
|
|
|
#endif
|