qelectrotech-source-mirror/sources/qetgraphicsitem/masterelement.cpp

/*
	Copyright 2006-2014 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/>.
*/
#include "masterelement.h"

/**
 * @brief MasterElement::MasterElement
 * Default constructor
 * @param location location of xml definition
 * @param qgi parent QGraphicItem
 * @param s parent diagram
 * @param state int used to know if the creation of element have error
 */
MasterElement::MasterElement(const ElementsLocation &location, QGraphicsItem *qgi, Diagram *s, int *state) :
	CustomElement(location, qgi, s, state)
{
	link_type_ = Master;
	cri_ = 0;
	connect(this, SIGNAL(elementInfoChange(DiagramContext)), this, SLOT(updateLabel()));
}

/**
 * @brief MasterElement::~MasterElement
 * default destructor
 */
MasterElement::~MasterElement() {
	unlinkAllElements();
	disconnect(this, SIGNAL(elementInfoChange(DiagramContext)), this, SLOT(updateLabel()));
}

/**
 * @brief MasterElement::linkToElement
 * Link this master to another element
 * For this class element must be a slave
 * @param elmt
 */
void MasterElement::linkToElement(Element *elmt) {	
	// check if element is slave and if isn't already linked
	if (elmt->linkType() == Slave && !connected_elements.contains(elmt)) {
		connected_elements << elmt;
		elmt->linkToElement(this);

		if (elmt->kindInformations()["type"].toString() == "power" && !diagram()->defaultXRefProperties().showPowerContact()) return;

		if (!cri_) {
				cri_ = new CrossRefItem(this); //create cross ref item if not yet
				diagram()->addItem(cri_);
			}
			connect(elmt, SIGNAL(positionChange(QPointF)), cri_, SLOT(updateLabel()));
			cri_->updateLabel();
		}
}

/**
 * @brief MasterElement::unlinkAllElements
 * Unlink all of the element in the QList connected_elements
 */
void MasterElement::unlinkAllElements() {
	// if this element is free no need to do something
	if (!isFree()) {
		foreach(Element *elmt, connected_elements) {
			unlinkElement(elmt);
		}
	}
}

/**
 * @brief MasterElement::unlinkElement
 * Unlink the given elmt in parametre
 * @param elmt element to unlink from this
 */
void MasterElement::unlinkElement(Element *elmt) {
	//Ensure elmt is linked to this element
	if (connected_elements.contains(elmt)) {
		connected_elements.removeOne(elmt);
		elmt->unlinkElement(this);
		//update the graphics cross ref
		disconnect(elmt, SIGNAL(positionChange(QPointF)), cri_, SLOT(updateLabel()));

		bool delete_cri = true;

		//if power contact isn't show, make sure they are only power contacts linked
		//or nothing befor remove cri_
		if (!diagram()->defaultXRefProperties().showPowerContact()) {
			foreach(Element *elmt, linkedElements())
				if (elmt->kindInformations()["type"].toString() != "power") delete_cri = false;
		}
		//else only make sur list is empty
		else {
			if (!linkedElements().isEmpty()) delete_cri = false;
		}

		if (delete_cri) {
			diagram()->removeItem(cri_);
			delete cri_;
			cri_ = 0;
		}
		else {
			cri_->updateLabel();
		}
	}
}

/**
 * @brief MasterElement::itemChange
 * Réimplemente the protected method item change
 * This is used to make connection/disconnection when this item is added/removed from a diagram
 * @return
 */
QVariant MasterElement::itemChange(GraphicsItemChange change, const QVariant &value) {
	if (change == QGraphicsItem::ItemSceneChange) {
		if (diagram())
			disconnect(diagram(), SIGNAL(XRefPropertiesChanged(XRefProperties)), this, SLOT(reLink()));
	}
	else if (change == QGraphicsItem::ItemSceneHasChanged) {
		if (diagram())
			connect(diagram(), SIGNAL(XRefPropertiesChanged(XRefProperties)), this, SLOT(reLink()));
	}
	return QetGraphicsItem::itemChange(change, value);
}


/**
 * @brief MasterElement::updateLabel
 * update label of this element
 */
void MasterElement::updateLabel() {
	QString label = elementInformations()["label"].toString();
	bool	show  = elementInformations().keyMustShow("label");

	// setup the label
	(label.isEmpty() || !show)?
				setTaggedText("label", "_", false):
				setTaggedText("label", label, true);
}

/**
 * @brief MasterElement::reLink
 * Relink all linked element.
 * this method is notably used when xref properties changes
 * for update the content of th e XRef
 */
void MasterElement::reLink() {
	QList <Element *> elmt_list = linkedElements();
	unlinkAllElements();
	foreach (Element *elmt, elmt_list) {
		linkToElement(elmt);
	}
}