/*
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 .
*/
#include "diagramcontext.h"
#include
#include "qet.h"
/**
@return a list containing all the keys in the context object.
*/
QList DiagramContext::keys(DiagramContext::KeyOrder order) const {
if (order == None) {
return content_.keys();
} else {
QList keys_list = content_.keys();
if (order == Alphabetical) {
qSort(keys_list);
} else {
qSort(keys_list.begin(), keys_list.end(), DiagramContext::stringLongerThan);
}
return(keys_list);
}
}
/**
@param key string key
@return true if that key is known to the diagram context, false otherwise
*/
bool DiagramContext::contains(const QString &key) const {
return(content_.contains(key));
}
/**
@param key
*/
const QVariant DiagramContext::operator[](const QString &key) const {
return(content_[key]);
}
/**
@param key key to insert in the context - the key may only contain lowercase
letters and dashes.
If embedded key is set, key must be find it else value is not added.
@see DiagramContext::keyIsAcceptable()
@param value value to insert in the context
@param show if value is used to be show on the diagram or somewhere else,
we can specify if he is show(true) or not(false)
@return true if the insertion succeeds, false otherwise
*/
bool DiagramContext::addValue(const QString &key, const QVariant &value, bool show) {
if (keyIsAcceptable(key)) {
content_.insert(key, value);
content_show.insert(key, show);
return(true);
}
return(false);
}
/**
Clear the content of this diagram context.
*/
void DiagramContext::clear() {
content_.clear();
content_show.clear();
}
/**
@return the number of key/value pairs stored in this object.
*/
int DiagramContext::count() {
return(content_.count());
}
/**
* @brief DiagramContext::keyMustShow
* @return the value pairs with key, if key no found, return false
*/
bool DiagramContext::keyMustShow(const QString &key) const {
if (content_show.contains(key))
return content_show[key];
return false;
}
bool DiagramContext::operator==(const DiagramContext &dc) const {
return(content_ == dc.content_ &&
content_show == dc.content_show);
}
bool DiagramContext::operator!=(const DiagramContext &dc) const {
return(!(*this == dc));
}
/**
Export this context properties under the \a e XML element, using tags
named \a tag_name (defaults to "property").
*/
void DiagramContext::toXml(QDomElement &e, const QString &tag_name) const {
foreach (QString key, keys()) {
QDomElement property = e.ownerDocument().createElement(tag_name);
property.setAttribute("name", key);
property.setAttribute("show",content_show[key]);
QDomText value = e.ownerDocument().createTextNode(content_[key].toString());
property.appendChild(value);
e.appendChild(property);
}
}
/**
Read this context properties from the \a e XML element, looking for tags named
\a tag_name (defaults to "property").
*/
void DiagramContext::fromXml(const QDomElement &e, const QString &tag_name) {
foreach (QDomElement property, QET::findInDomElement(e, tag_name)) {
if (!property.hasAttribute("name")) continue;
addValue(property.attribute("name"), QVariant(property.text()));
content_show.insert(property.attribute("name"), property.attribute("show", "1").toInt());
}
}
/**
Export this context properties to \a settings by creating an array named \a
array_name.
*/
void DiagramContext::toSettings(QSettings &settings, const QString &array_name) const {
settings.beginWriteArray(array_name);
int i = 0;
foreach (QString key, content_.keys()) {
settings.setArrayIndex(i);
settings.setValue("name", key);
settings.setValue("value", content_[key].toString());
++ i;
}
settings.endArray();
}
/**
Read this context properties from \a settings by running through the array
named \a array_name.
*/
void DiagramContext::fromSettings(QSettings &settings, const QString &array_name) {
int size = settings.beginReadArray(array_name);
for (int i = 0 ; i < size; ++ i) {
settings.setArrayIndex(i);
QString key = settings.value("name").toString();
if (key.isEmpty()) continue;
addValue(key, settings.value("value").toString());
}
settings.endArray();
}
/**
@return the regular expression used to check whether a given key is acceptable.
@see keyIsAcceptable()
*/
QString DiagramContext::validKeyRegExp() {
return("^[a-z0-9-]+$");
}
/**
@return True if \a a is longer than \a b, false otherwise.
*/
bool DiagramContext::stringLongerThan(const QString &a, const QString &b) {
return (a.length() > b.length());
}
/**
@param key a key string
@return true if that key is acceptable, false otherwise
*/
bool DiagramContext::keyIsAcceptable(const QString &key) const {
static QRegExp re(DiagramContext::validKeyRegExp());
return(re.exactMatch(key));
}