diff options
Diffstat (limited to 'src/qconfig/feature.cpp')
| -rw-r--r-- | src/qconfig/feature.cpp | 240 |
1 files changed, 240 insertions, 0 deletions
diff --git a/src/qconfig/feature.cpp b/src/qconfig/feature.cpp new file mode 100644 index 000000000..358dec517 --- /dev/null +++ b/src/qconfig/feature.cpp @@ -0,0 +1,240 @@ +/**************************************************************************** +** +** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). +** All rights reserved. +** Contact: Nokia Corporation (qt-info@nokia.com) +** +** This file is part of the tools applications of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:LGPL$ +** No Commercial Usage +** This file contains pre-release code and may not be distributed. +** You may use this file in accordance with the terms and conditions +** contained in the Technology Preview License Agreement accompanying +** this package. +** +** GNU Lesser General Public License Usage +** Alternatively, this file may be used under the terms of the GNU Lesser +** General Public License version 2.1 as published by the Free Software +** Foundation and appearing in the file LICENSE.LGPL included in the +** packaging of this file. Please review the following information to +** ensure the GNU Lesser General Public License version 2.1 requirements +** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. +** +** In addition, as a special exception, Nokia gives you certain additional +** rights. These rights are described in the Nokia Qt LGPL Exception +** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. +** +** If you have questions regarding the use of this file, please contact +** Nokia at qt-info@nokia.com. +** +** +** +** +** +** +** +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#include "feature.h" +#include <QTextStream> +#include <QRegExp> +#include <QLibraryInfo> +#include <QFileInfo> +#include <QApplication> +#include <QPalette> + +QT_BEGIN_NAMESPACE + +QMap<QString, Feature*> Feature::instances; + +Feature* Feature::getInstance(const QString &key) +{ + QString ukey = key.toUpper(); + if (!instances.contains(ukey)) + instances[ukey] = new Feature(ukey); + return instances[ukey]; +} + +Feature::~Feature() +{ + delete d; +} + +void Feature::clear() +{ + foreach (Feature *f, instances.values()) + delete f; + instances.clear(); +} + +static QString listToHtml(const QString &title, const QStringList &list) +{ + if (list.isEmpty()) + return QString(); + + QString str; + QTextStream stream(&str); + + stream << "<h3>" << title << ":</h3>"; + stream << "<ul>"; + foreach (QString l, list) + stream << "<li>" << l << "</li>"; + stream << "</ul>"; + + return str; +} + +static QString listToHtml(const QString &title, const QList<Feature*> &list) +{ + QStringList stringlist; + foreach (Feature *f, list) { + QString s("[%3] <a href=\"feature://%1\">%2</a>"); + s = s.arg(f->key()).arg(f->key()); + s = s.arg(f->selectable() && f->enabled() ? "On" : "Off"); + stringlist << s; + } + return listToHtml(title, stringlist); +} + +static QString linkify(const QString &src) +{ + static QRegExp classRegexp("\\b(Q[\\w]+)"); + QString docRoot = QLibraryInfo::location(QLibraryInfo::DocumentationPath); + QString result = src; + int pos = 0; + while ((pos = classRegexp.indexIn(result, pos)) != -1) { + QString className = classRegexp.cap(1); + QString file = docRoot + "/html/" + className.toLower() + ".html"; + QFileInfo info(file); + if (info.isFile()) { + QString link = QString("<a href=\"file://%1\">%2</a>") + .arg(file).arg(className); + result.replace(pos, className.length(), link); + pos += link.length(); + } else { + pos += className.length(); + } + } + + return result; +} + +QString Feature::toHtml() const +{ + QString str; + QTextStream stream(&str); + + const QString linkColor = QApplication::palette().color(QPalette::Link).name(); + stream << "<h2><font size=\"+2\" color=\"" << linkColor << "\">" + << key() << "</font></h2>" + << "<h2><font size=\"+2\">" << title() << "</font></h2>"; + if (!description().isEmpty()) + stream << "<p>" << description() << "</p>"; + stream << listToHtml("Section", QStringList(section())) + << listToHtml("Requires", dependencies()) + << listToHtml("Required for", supports()) + << listToHtml("See also", relations()); + + return linkify(str); +} + +Feature::Feature(const QString &key) : d(new FeaturePrivate(key)) {} + +void Feature::setTitle(const QString &title) +{ + d->title = title; +} + +void Feature::setSection(const QString §ion) +{ + d->section = section; +} + +void Feature::setDescription(const QString &description) +{ + d->description = description; +} + +void Feature::addRelation(const QString &key) +{ + d->relations.insert(getInstance(key)); +} + +void Feature::setRelations(const QStringList &keys) +{ + foreach(QString key, keys) + if (key != "???") + addRelation(key); +} + +QList<Feature*> Feature::relations() const +{ + return d->relations.toList(); +} + +void Feature::addDependency(const QString &key) +{ + Feature *f = getInstance(key); + d->dependencies.insert(f); + f->d->supports.insert(this); +} + +void Feature::setDependencies(const QStringList &keys) +{ + foreach(QString key, keys) + addDependency(key); +} + +QList<Feature*> Feature::dependencies() const +{ + return d->dependencies.toList(); +} + +QList<Feature*> Feature::supports() const +{ + return d->supports.toList(); +} + +/* + Returns a html formatted detailed description of this Feature. +*/ +QString Feature::getDocumentation() const +{ + return QString() + "<h2>" + d->title + "</h2>"; + +} + +void Feature::setEnabled(bool on) +{ + if (on == d->enabled) + return; + + d->enabled = on; + foreach (Feature *f, supports()) + f->updateSelectable(); + emit changed(); +} + +/* + Update whether this feature should be selectable. + A feature is selectable if all its dependencies are enabled. +*/ +void Feature::updateSelectable() +{ + bool selectable = true; + foreach (Feature *f, dependencies()) + if (!f->selectable() || !f->enabled()) + selectable = false; + if (selectable != d->selectable) { + d->selectable = selectable; + foreach (Feature *f, supports()) + f->updateSelectable(); + emit changed(); + } +} + +QT_END_NAMESPACE |