qelectrotech-source-mirror/terminal.h

#ifndef BORNE_H
#define BORNE_H
#define TAILLE_BORNE 4
#include <QtGui>
#include <QtXml>
class Conducer;
class Element;
class Diagram;
/**
	Classe modelisant la <EFBFBD> borne <EFBFBD> d'un appareil, c'est-a-dire un
	branchement possible pour un Conducteur.
*/
class Terminal : public QGraphicsItem {
	public:
	// enum definissant l'orientation de la borne
	enum Orientation {Nord, Est, Sud, Ouest};
	
	// permet de caster un QGraphicsItem en Borne avec qgraphicsitem_cast
	enum { Type = UserType + 1002 };
	virtual int type() const { return Type; }
	
	// constructeurs
	Terminal();
	Terminal(QPointF,      Terminal::Orientation, Element * = 0, Diagram * = 0);
	Terminal(qreal, qreal, Terminal::Orientation, Element * = 0, Diagram * = 0);
	
	// destructeur
	~Terminal();
	
	// implementation des methodes virtuelles pures de QGraphicsItem
	void paint(QPainter *, const QStyleOptionGraphicsItem *, QWidget *);
	QRectF boundingRect() const;
	
	// methodes de manipulation des conducteurs lies a cette borne
	bool addConducer(Conducer *);
	void removeConducer(Conducer *);
	int nbConducers() const;
	
	// methodes de lecture
	QList<Conducer *> conducers() const; 
	Terminal::Orientation orientation() const;
	QPointF amarrageConducer() const;
	void updateConducer(QPointF = QPointF());
	
	// methodes relatives a l'import/export au format XML
	static bool valideXml(QDomElement  &);
	bool        fromXml  (QDomElement  &);
	QDomElement toXml    (QDomDocument &) const;
	
	protected:
	// methodes de gestion des evenements
	void hoverEnterEvent  (QGraphicsSceneHoverEvent *);
	void hoverMoveEvent   (QGraphicsSceneHoverEvent *);
	void hoverLeaveEvent  (QGraphicsSceneHoverEvent *);
	void mousePressEvent  (QGraphicsSceneMouseEvent *);
	void mouseMoveEvent   (QGraphicsSceneMouseEvent *);
	void mouseReleaseEvent(QGraphicsSceneMouseEvent *);
	
	private:
	// pointeur vers la QGraphicsScene de type Diagram (evite quelques casts en interne)
	Diagram *diagram_scene;
	// coordonnees des points d'amarrage
	QPointF amarrage_conducer;
	QPointF amarrage_elmt;
	// orientation de la borne
	Terminal::Orientation sens;
	// liste des conducers lies a cette borne
	QList<Conducer *> liste_conducers;
	// pointeur vers un rectangle correspondant au bounding rect ; permet de ne calculer le bounding rect qu'une seule fois ; le pointeur c'est parce que le compilo exige une methode const
	QRectF *br;
	Terminal *terminal_precedente;
	bool hovered;
	// methode initialisant les differents membres de la borne
	void initialise(QPointF, Terminal::Orientation);
	// differentes couleurs utilisables pour l'effet "hover"
	QColor couleur_hovered;
	QColor couleur_neutre;
	QColor couleur_autorise;
	QColor couleur_prudence;
	QColor couleur_interdit;
};

/**
	@return Le nombre de conducteurs associes a la borne
*/
inline int Terminal::nbConducers() const {
	return(liste_conducers.size());
}

/**
	@return La position du point d'amarrage de la borne
*/
inline QPointF Terminal::amarrageConducer() const {
	return(mapToScene(amarrage_conducer));
}

#endif