qelectrotech-source-mirror/sources/qetgraphicsitem/crossrefitem.h

/*
	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 CROSSREFITEM_H
#define CROSSREFITEM_H

#include <QGraphicsObject>
#include"properties/xrefproperties.h"
#include <QPicture>

class Element;

/**
 * @brief The CrossRefItem class
 * This clas provide an item, for show the cross reference, like the contacts linked to a coil.
 * The item setpos automaticaly when parent move.
 * All slave displayed in cross ref will be updated when folio position change in the project.
 * It's the responsability of the master element to informe displayed slave are moved,
 * by calling the slot @updateLabel
 * By default master element is the parent graphics item of this Xref,
 * but if the Xref must be snap to the label of master, the label become the parent of this Xref.
 * This behavior can be changed at anytime by calling setProperties.
 */
class CrossRefItem : public QGraphicsObject
{
	Q_OBJECT

		//Methods
	public:
		explicit CrossRefItem(Element *elmt);
		~CrossRefItem();

		enum { Type = UserType + 1009 };
		virtual int type() const { return Type; }

		enum CONTACTS {
			NO       = 1,
			NC       = 2,
			NOC      = 3,
			SW       = 4,
			Power    = 8,
			DelayOn  = 16,
			DelayOff = 32,
			Delay    = 48
		};

		QRectF boundingRect			() const;
		virtual QPainterPath shape	() const;
		QString elementPositionText (const Element *elmt, const bool &add_prefix = false) const;

	public slots:
		void updateProperties ();
		void updateLabel   ();
		void autoPos	   ();

	protected:
		virtual void paint (QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget);
		virtual void mouseDoubleClickEvent (QGraphicsSceneMouseEvent * event );
		virtual void hoverEnterEvent(QGraphicsSceneHoverEvent *event);
		virtual void hoverMoveEvent(QGraphicsSceneHoverEvent *event);
		virtual void hoverLeaveEvent(QGraphicsSceneHoverEvent *event);

	private:
		void buildHeaderContact		();
		void setUpCrossBoundingRect (QPainter &painter);
		void drawAsCross			(QPainter &painter);
		void drawAsContacts		(QPainter &painter);
		QRectF drawContact			(QPainter &painter, int flags, Element *elmt);
		void fillCrossRef			(QPainter &painter);
		void AddExtraInfo			(QPainter &painter, QString);
		void setTextParent			();
		QList<Element *> NOElements() const;
		QList<Element *> NCElements() const;

		//Attributes
	private:
		Element		  *m_element; //element to display the cross reference
		QRectF		   m_bounding_rect;
		QPicture	   m_drawing, m_hdr_no_ctc, m_hdr_nc_ctc;
		QPainterPath   m_shape_path;
		XRefProperties m_properties;
		int			   m_drawed_contacts;
		QMap <Element *, QRectF> m_hovered_contacts_map;
		Element *m_hovered_contact = nullptr;

};

#endif // CROSSREFITEM_H