/**************************************************************************** ** ** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). ** All rights reserved. ** Contact: Nokia Corporation (qt-info@nokia.com) ** ** This file is part of the Qt Designer of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial Usage ** Licensees holding valid Qt Commercial licenses may use this file in ** accordance with the Qt Commercial License Agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and Nokia. ** ** 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. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3.0 as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU General Public License version 3.0 requirements will be ** met: http://www.gnu.org/copyleft/gpl.html. ** ** If you have questions regarding the use of this file, please contact ** Nokia at qt-info@nokia.com. ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "qdesigner_promotion_p.h" #include "widgetdatabase_p.h" #include "metadatabase_p.h" #include "widgetdatabase_p.h" #include #include #include #include #include #include #include #include #include QT_BEGIN_NAMESPACE namespace { // Return a set of on-promotable classes const QSet &nonPromotableClasses() { static QSet rc; if (rc.empty()) { rc.insert(QLatin1String("Line")); rc.insert(QLatin1String("QAction")); rc.insert(QLatin1String("Spacer")); rc.insert(QLatin1String("QMainWindow")); rc.insert(QLatin1String("QDialog")); rc.insert(QLatin1String("QWorkspace")); rc.insert(QLatin1String("QMdiArea")); rc.insert(QLatin1String("QMdiSubWindow")); } return rc; } // Return widget database index of a promoted class or -1 with error message int promotedWidgetDataBaseIndex(const QDesignerWidgetDataBaseInterface *widgetDataBase, const QString &className, QString *errorMessage) { const int index = widgetDataBase->indexOfClassName(className); if (index == -1 || !widgetDataBase->item(index)->isPromoted()) { *errorMessage = QCoreApplication::tr("%1 is not a promoted class.").arg(className); return -1; } return index; } // Return widget database item of a promoted class or 0 with error message QDesignerWidgetDataBaseItemInterface *promotedWidgetDataBaseItem(const QDesignerWidgetDataBaseInterface *widgetDataBase, const QString &className, QString *errorMessage) { const int index = promotedWidgetDataBaseIndex(widgetDataBase, className, errorMessage); if (index == -1) return 0; return widgetDataBase->item(index); } // extract class name from xml "". Quite a hack. QString classNameFromXml(QString xml) { static const QString tag = QLatin1String("class=\""); const int pos = xml.indexOf(tag); if (pos == -1) return QString(); xml.remove(0, pos + tag.size()); const int closingPos = xml.indexOf(QLatin1Char('"')); if (closingPos == -1) return QString(); xml.remove(closingPos, xml.size() - closingPos); return xml; } // return a list of class names in the scratch pad QStringList getScratchPadClasses(const QDesignerWidgetBoxInterface *wb) { QStringList rc; const int catCount = wb->categoryCount(); for (int c = 0; c < catCount; c++) { const QDesignerWidgetBoxInterface::Category category = wb->category(c); if (category.type() == QDesignerWidgetBoxInterface::Category::Scratchpad) { const int widgetCount = category.widgetCount(); for (int w = 0; w < widgetCount; w++) { const QString className = classNameFromXml( category.widget(w).domXml()); if (!className.isEmpty()) rc += className; } } } return rc; } } namespace qdesigner_internal { QDesignerPromotion::QDesignerPromotion(QDesignerFormEditorInterface *core) : m_core(core) { } bool QDesignerPromotion::addPromotedClass(const QString &baseClass, const QString &className, const QString &includeFile, QString *errorMessage) { QDesignerWidgetDataBaseInterface *widgetDataBase = m_core->widgetDataBase(); const int baseClassIndex = widgetDataBase->indexOfClassName(baseClass); if (baseClassIndex == -1) { *errorMessage = QCoreApplication::tr("The base class %1 is invalid.").arg(baseClass); return false; } const int existingClassIndex = widgetDataBase->indexOfClassName(className); if (existingClassIndex != -1) { *errorMessage = QCoreApplication::tr("The class %1 already exists.").arg(className); return false; } // Clone derived item. QDesignerWidgetDataBaseItemInterface *promotedItem = WidgetDataBaseItem::clone(widgetDataBase->item(baseClassIndex)); // Also inherit the container flag in case of QWidget-derived classes // as it is most likely intended for stacked pages. // set new props promotedItem->setName(className); promotedItem->setGroup(QCoreApplication::tr("Promoted Widgets")); promotedItem->setCustom(true); promotedItem->setPromoted(true); promotedItem->setExtends(baseClass); promotedItem->setIncludeFile(includeFile); widgetDataBase->append(promotedItem); return true; } QList QDesignerPromotion::promotionBaseClasses() const { typedef QMap SortedDatabaseItemMap; SortedDatabaseItemMap sortedDatabaseItemMap; QDesignerWidgetDataBaseInterface *widgetDataBase = m_core->widgetDataBase(); const int cnt = widgetDataBase->count(); for (int i = 0; i < cnt; i++) { QDesignerWidgetDataBaseItemInterface *dbItem = widgetDataBase->item(i); if (canBePromoted(dbItem)) { sortedDatabaseItemMap.insert(dbItem->name(), dbItem); } } return sortedDatabaseItemMap.values(); } bool QDesignerPromotion::canBePromoted(const QDesignerWidgetDataBaseItemInterface *dbItem) const { if (dbItem->isPromoted() || !dbItem->extends().isEmpty()) return false; const QString name = dbItem->name(); if (nonPromotableClasses().contains(name)) return false; if (name.startsWith(QLatin1String("QDesigner")) || name.startsWith(QLatin1String("QLayout"))) return false; return true; } QDesignerPromotion::PromotedClasses QDesignerPromotion::promotedClasses() const { typedef QMap ClassNameItemMap; // A map containing base classes and their promoted classes. typedef QMap BaseClassPromotedMap; BaseClassPromotedMap baseClassPromotedMap; QDesignerWidgetDataBaseInterface *widgetDataBase = m_core->widgetDataBase(); // Look for promoted classes and insert into map according to base class. const int cnt = widgetDataBase->count(); for (int i = 0; i < cnt; i++) { QDesignerWidgetDataBaseItemInterface *dbItem = widgetDataBase->item(i); if (dbItem->isPromoted()) { const QString baseClassName = dbItem->extends(); BaseClassPromotedMap::iterator it = baseClassPromotedMap.find(baseClassName); if (it == baseClassPromotedMap.end()) { it = baseClassPromotedMap.insert(baseClassName, ClassNameItemMap()); } it.value().insert(dbItem->name(), dbItem); } } // convert map into list. PromotedClasses rc; if (baseClassPromotedMap.empty()) return rc; const BaseClassPromotedMap::const_iterator bcend = baseClassPromotedMap.constEnd(); for (BaseClassPromotedMap::const_iterator bit = baseClassPromotedMap.constBegin(); bit != bcend; ++bit) { const int baseIndex = widgetDataBase->indexOfClassName(bit.key()); Q_ASSERT(baseIndex >= 0); QDesignerWidgetDataBaseItemInterface *baseItem = widgetDataBase->item(baseIndex); // promoted const ClassNameItemMap::const_iterator pcend = bit.value().constEnd(); for (ClassNameItemMap::const_iterator pit = bit.value().constBegin(); pit != pcend; ++pit) { PromotedClass item; item.baseItem = baseItem; item.promotedItem = pit.value(); rc.push_back(item); } } return rc; } QSet QDesignerPromotion::referencedPromotedClassNames() const { QSet rc; const MetaDataBase *metaDataBase = qobject_cast(m_core->metaDataBase()); if (!metaDataBase) return rc; const QList objs = metaDataBase->objects(); const QList::const_iterator cend = objs.constEnd(); for ( QList::const_iterator it = objs.constBegin(); it != cend; ++it) { const QString customClass = metaDataBase->metaDataBaseItem(*it)->customClassName(); if (!customClass.isEmpty()) rc.insert(customClass); } // check the scratchpad of the widget box if (QDesignerWidgetBoxInterface *widgetBox = m_core->widgetBox()) { const QStringList scratchPadClasses = getScratchPadClasses(widgetBox); if (!scratchPadClasses.empty()) { // Check whether these are actually promoted QDesignerWidgetDataBaseInterface *widgetDataBase = m_core->widgetDataBase(); QStringList::const_iterator cend = scratchPadClasses.constEnd(); for (QStringList::const_iterator it = scratchPadClasses.constBegin(); it != cend; ++it ) { const int index = widgetDataBase->indexOfClassName(*it); if (index != -1 && widgetDataBase->item(index)->isPromoted()) rc += *it; } } } return rc; } bool QDesignerPromotion::removePromotedClass(const QString &className, QString *errorMessage) { // check if it exists and is promoted WidgetDataBase *widgetDataBase = qobject_cast(m_core->widgetDataBase()); if (!widgetDataBase) { *errorMessage = QCoreApplication::tr("The class %1 cannot be removed").arg(className); return false; } const int index = promotedWidgetDataBaseIndex(widgetDataBase, className, errorMessage); if (index == -1) return false; if (referencedPromotedClassNames().contains(className)) { *errorMessage = QCoreApplication::tr("The class %1 cannot be removed because it is still referenced.").arg(className); return false; } widgetDataBase->remove(index); return true; } bool QDesignerPromotion::changePromotedClassName(const QString &oldclassName, const QString &newClassName, QString *errorMessage) { const MetaDataBase *metaDataBase = qobject_cast(m_core->metaDataBase()); if (!metaDataBase) { *errorMessage = QCoreApplication::tr("The class %1 cannot be renamed").arg(oldclassName); return false; } QDesignerWidgetDataBaseInterface *widgetDataBase = m_core->widgetDataBase(); // check the new name if (newClassName.isEmpty()) { *errorMessage = QCoreApplication::tr("The class %1 cannot be renamed to an empty name.").arg(oldclassName); return false; } const int existingIndex = widgetDataBase->indexOfClassName(newClassName); if (existingIndex != -1) { *errorMessage = QCoreApplication::tr("There is already a class named %1.").arg(newClassName); return false; } // Check old class QDesignerWidgetDataBaseItemInterface *dbItem = promotedWidgetDataBaseItem(widgetDataBase, oldclassName, errorMessage); if (!dbItem) return false; // Change the name in the data base and change all referencing objects in the meta database dbItem->setName(newClassName); bool foundReferences = false; foreach (QObject* object, metaDataBase->objects()) { MetaDataBaseItem *item = metaDataBase->metaDataBaseItem(object); Q_ASSERT(item); if (item->customClassName() == oldclassName) { item->setCustomClassName(newClassName); foundReferences = true; } } // set state if (foundReferences) refreshObjectInspector(); return true; } bool QDesignerPromotion::setPromotedClassIncludeFile(const QString &className, const QString &includeFile, QString *errorMessage) { // check file if (includeFile.isEmpty()) { *errorMessage = QCoreApplication::tr("Cannot set an empty include file."); return false; } // check item QDesignerWidgetDataBaseInterface *widgetDataBase = m_core->widgetDataBase(); QDesignerWidgetDataBaseItemInterface *dbItem = promotedWidgetDataBaseItem(widgetDataBase, className, errorMessage); if (!dbItem) return false; dbItem->setIncludeFile(includeFile); return true; } void QDesignerPromotion::refreshObjectInspector() { if (QDesignerFormWindowManagerInterface *fwm = m_core->formWindowManager()) { if (QDesignerFormWindowInterface *fw = fwm->activeFormWindow()) if ( QDesignerObjectInspectorInterface *oi = m_core->objectInspector()) { oi->setFormWindow(fw); } } } } QT_END_NAMESPACE