Long live Qt for S60!

1 files changed, 562 insertions, 0 deletions

diff --git a/tools/designer/src/lib/uilib/formbuilder.cpp b/tools/designer/src/lib/uilib/formbuilder.cpp
new file mode 100644
index 0000000..414eb14
--- /dev/null
+++ b/tools/designer/src/lib/uilib/formbuilder.cpp
@@ -0,0 +1,562 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** Contact: Qt Software Information (qt-info@nokia.com)
+**
+** This file is part of the Qt Designer 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 either Technology Preview License Agreement or the
+** Beta Release License Agreement.
+**
+** 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.0, 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 are unsure which license is appropriate for your use, please
+** contact the sales department at qt-sales@nokia.com.
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#include "customwidget.h"
+#include "formbuilder.h"
+#include "formbuilderextra_p.h"
+#include "ui4_p.h"
+
+#include <QtGui/QtGui>
+#include <QtCore/QCoreApplication>
+
+QT_BEGIN_NAMESPACE
+
+#ifdef QFORMINTERNAL_NAMESPACE
+namespace QFormInternal {
+#endif
+
+/*!
+    \class QFormBuilder
+
+    \brief The QFormBuilder class is used to dynamically construct
+    user interfaces from .ui files at run-time.
+
+    \inmodule QtDesigner
+
+    The QFormBuilder class provides a mechanism for dynamically
+    creating user interfaces at run-time, based on \c{.ui} files
+    created with \QD. For example:
+
+    \snippet doc/src/snippets/code/tools_designer_src_lib_uilib_formbuilder.cpp 0
+
+    By including the user interface in the example's resources (\c
+    myForm.qrc), we ensure that it will be present when the example is
+    run:
+
+    \snippet doc/src/snippets/code/tools_designer_src_lib_uilib_formbuilder.cpp 1
+
+    QFormBuilder extends the QAbstractFormBuilder base class with a
+    number of functions that are used to support custom widget
+    plugins:
+
+    \list
+    \o pluginPaths() returns the list of paths that the form builder
+       searches when loading custom widget plugins.
+    \o addPluginPath() allows additional paths to be registered with
+       the form builder.
+    \o setPluginPath() is used to replace the existing list of paths
+       with a list obtained from some other source.
+    \o clearPluginPaths() removes all paths registered with the form
+       builder.
+    \o customWidgets() returns a list of interfaces to plugins that
+       can be used to create new instances of registered custom widgets.
+    \endlist
+
+    The QFormBuilder class is typically used by custom components and
+    applications that embed \QD. Standalone applications that need to
+    dynamically generate user interfaces at run-time use the
+    QUiLoader class, found in the QtUiTools module.
+
+    \sa QAbstractFormBuilder, {QtUiTools Module}
+*/
+
+/*!
+    \fn QFormBuilder::QFormBuilder()
+
+    Constructs a new form builder.
+*/
+
+QFormBuilder::QFormBuilder() : QAbstractFormBuilder()
+{
+}
+
+/*!
+    Destroys the form builder.
+*/
+QFormBuilder::~QFormBuilder()
+{
+}
+
+/*!
+    \internal
+*/
+QWidget *QFormBuilder::create(DomWidget *ui_widget, QWidget *parentWidget)
+{
+    QFormBuilderExtra::instance(this)->setProcessingLayoutWidget(false);
+    if (ui_widget->attributeClass() == QFormBuilderStrings::instance().qWidgetClass && !ui_widget->hasAttributeNative()
+            && parentWidget
+#ifndef QT_NO_MAINWINDOW
+            && !qobject_cast<QMainWindow *>(parentWidget)
+#endif
+#ifndef QT_NO_TOOLBOX
+            && !qobject_cast<QToolBox *>(parentWidget)
+#endif
+#ifndef QT_NO_STACKEDWIDGET
+            && !qobject_cast<QStackedWidget *>(parentWidget)
+#endif
+#ifndef QT_NO_STACKEDWIDGET
+            && !qobject_cast<QTabWidget *>(parentWidget)
+#endif
+#ifndef QT_NO_SCROLLAREA
+            && !qobject_cast<QScrollArea *>(parentWidget)
+#endif
+#ifndef QT_NO_MDIAREA
+            && !qobject_cast<QMdiArea *>(parentWidget)
+#endif
+#ifndef QT_NO_DOCKWIDGET
+            && !qobject_cast<QDockWidget *>(parentWidget)
+#endif
+            )
+        QFormBuilderExtra::instance(this)->setProcessingLayoutWidget(true);
+    return QAbstractFormBuilder::create(ui_widget, parentWidget);
+}
+
+
+/*!
+    \internal
+*/
+QWidget *QFormBuilder::createWidget(const QString &widgetName, QWidget *parentWidget, const QString &name)
+{
+    if (widgetName.isEmpty()) {
+        //: Empty class name passed to widget factory method
+        qWarning() << QCoreApplication::translate("QFormBuilder", "An empty class name was passed on to %1 (object name: '%2').").arg(QString::fromUtf8(Q_FUNC_INFO), name);
+        return 0;
+    }
+
+    QWidget *w = 0;
+
+#ifndef QT_NO_TABWIDGET
+    if (qobject_cast<QTabWidget*>(parentWidget))
+        parentWidget = 0;
+#endif
+#ifndef QT_NO_STACKEDWIDGET
+    if (qobject_cast<QStackedWidget*>(parentWidget))
+        parentWidget = 0;
+#endif
+#ifndef QT_NO_TOOLBOX
+    if (qobject_cast<QToolBox*>(parentWidget))
+        parentWidget = 0;
+#endif
+
+    // ### special-casing for Line (QFrame) -- fix for 4.2
+    do {
+        if (widgetName == QFormBuilderStrings::instance().lineClass) {
+            w = new QFrame(parentWidget);
+            static_cast<QFrame*>(w)->setFrameStyle(QFrame::HLine | QFrame::Sunken);
+            break;
+        }
+        const QByteArray widgetNameBA = widgetName.toUtf8();
+        const char *widgetNameC = widgetNameBA.constData();
+        if (w) { // symmetry for macro
+        }
+
+#define DECLARE_LAYOUT(L, C)
+#define DECLARE_COMPAT_WIDGET(W, C)
+#define DECLARE_WIDGET(W, C) else if (!qstrcmp(widgetNameC, #W)) { Q_ASSERT(w == 0); w = new W(parentWidget); }
+#define DECLARE_WIDGET_1(W, C) else if (!qstrcmp(widgetNameC, #W)) { Q_ASSERT(w == 0); w = new W(0, parentWidget); }
+
+#include "widgets.table"
+
+#undef DECLARE_COMPAT_WIDGET
+#undef DECLARE_LAYOUT
+#undef DECLARE_WIDGET
+#undef DECLARE_WIDGET_1
+
+        if (w)
+            break;
+
+        // try with a registered custom widget
+        QDesignerCustomWidgetInterface *factory = m_customWidgets.value(widgetName);
+        if (factory != 0)
+            w = factory->createWidget(parentWidget);
+    } while(false);
+
+    QFormBuilderExtra *fb = QFormBuilderExtra::instance(this);
+    if (w == 0) { // Attempt to instantiate base class of promoted/custom widgets
+        const QString baseClassName = fb->customWidgetBaseClass(widgetName);
+        if (!baseClassName.isEmpty()) {
+            qWarning() << QCoreApplication::translate("QFormBuilder", "QFormBuilder was unable to create a custom widget of the class '%1'; defaulting to base class '%2'.").arg(widgetName, baseClassName);
+            return createWidget(baseClassName, parentWidget, name);
+        }
+    }
+
+    if (w == 0) { // nothing to do
+        qWarning() << QCoreApplication::translate("QFormBuilder", "QFormBuilder was unable to create a widget of the class '%1'.").arg(widgetName);
+        return 0;
+    }
+
+    w->setObjectName(name);
+
+    if (qobject_cast<QDialog *>(w))
+        w->setParent(parentWidget);
+
+    if (!fb->rootWidget())
+        fb->setRootWidget(w);
+
+    return w;
+}
+
+/*!
+    \internal
+*/
+QLayout *QFormBuilder::createLayout(const QString &layoutName, QObject *parent, const QString &name)
+{
+    QLayout *l = 0;
+
+    QWidget *parentWidget = qobject_cast<QWidget*>(parent);
+    QLayout *parentLayout = qobject_cast<QLayout*>(parent);
+
+    Q_ASSERT(parentWidget || parentLayout);
+
+#define DECLARE_WIDGET(W, C)
+#define DECLARE_COMPAT_WIDGET(W, C)
+
+#define DECLARE_LAYOUT(L, C) \
+    if (layoutName == QLatin1String(#L)) { \
+        Q_ASSERT(l == 0); \
+        l = parentLayout \
+            ? new L() \
+            : new L(parentWidget); \
+    }
+
+#include "widgets.table"
+
+#undef DECLARE_LAYOUT
+#undef DECLARE_COMPAT_WIDGET
+#undef DECLARE_WIDGET
+
+    if (l) {
+        l->setObjectName(name);
+        if (parentLayout) {
+            QWidget *w = qobject_cast<QWidget *>(parentLayout->parent());
+            if (w && w->inherits("Q3GroupBox")) {
+                l->setContentsMargins(w->style()->pixelMetric(QStyle::PM_LayoutLeftMargin),
+                                    w->style()->pixelMetric(QStyle::PM_LayoutTopMargin),
+                                    w->style()->pixelMetric(QStyle::PM_LayoutRightMargin),
+                                    w->style()->pixelMetric(QStyle::PM_LayoutBottomMargin));
+                QGridLayout *grid = qobject_cast<QGridLayout *>(l);
+                if (grid) {
+                    grid->setHorizontalSpacing(-1);
+                    grid->setVerticalSpacing(-1);
+                } else {
+                    l->setSpacing(-1);
+                }
+                l->setAlignment(Qt::AlignTop);
+            }
+        }
+    } else {
+        qWarning() << QCoreApplication::translate("QFormBuilder", "The layout type `%1' is not supported.").arg(layoutName);
+    }
+
+    return l;
+}
+
+/*!
+    \internal
+*/
+bool QFormBuilder::addItem(DomLayoutItem *ui_item, QLayoutItem *item, QLayout *layout)
+{
+    return QAbstractFormBuilder::addItem(ui_item, item, layout);
+}
+
+/*!
+    \internal
+*/
+bool QFormBuilder::addItem(DomWidget *ui_widget, QWidget *widget, QWidget *parentWidget)
+{
+    return QAbstractFormBuilder::addItem(ui_widget, widget, parentWidget);
+}
+
+/*!
+    \internal
+*/
+QWidget *QFormBuilder::widgetByName(QWidget *topLevel, const QString &name)
+{
+    Q_ASSERT(topLevel);
+    if (topLevel->objectName() == name)
+        return topLevel;
+
+    return qFindChild<QWidget*>(topLevel, name);
+}
+
+static QObject *objectByName(QWidget *topLevel, const QString &name)
+{
+    Q_ASSERT(topLevel);
+    if (topLevel->objectName() == name)
+        return topLevel;
+
+    return qFindChild<QObject*>(topLevel, name);
+}
+
+/*!
+    \internal
+*/
+void QFormBuilder::createConnections(DomConnections *ui_connections, QWidget *widget)
+{
+    typedef QList<DomConnection*> DomConnectionList;
+    Q_ASSERT(widget != 0);
+
+    if (ui_connections == 0)
+        return;
+
+    const DomConnectionList connections = ui_connections->elementConnection();
+    if (!connections.empty()) {
+        const DomConnectionList::const_iterator cend = connections.constEnd();
+        for (DomConnectionList::const_iterator it = connections.constBegin(); it != cend; ++it) {
+
+            QObject *sender = objectByName(widget, (*it)->elementSender());
+            QObject *receiver = objectByName(widget, (*it)->elementReceiver());
+            if (!sender || !receiver)
+                continue;
+
+            QByteArray sig = (*it)->elementSignal().toUtf8();
+            sig.prepend("2");
+            QByteArray sl = (*it)->elementSlot().toUtf8();
+            sl.prepend("1");
+            QObject::connect(sender, sig, receiver, sl);
+        }
+    }
+}
+
+/*!
+    \internal
+*/
+QWidget *QFormBuilder::create(DomUI *ui, QWidget *parentWidget)
+{
+    return QAbstractFormBuilder::create(ui, parentWidget);
+}
+
+/*!
+    \internal
+*/
+QLayout *QFormBuilder::create(DomLayout *ui_layout, QLayout *layout, QWidget *parentWidget)
+{
+    // Is this a temporary layout widget used to represent QLayout hierarchies in Designer?
+    // Set its margins to 0.
+    bool layoutWidget = QFormBuilderExtra::instance(this)->processingLayoutWidget();
+    QLayout *l = QAbstractFormBuilder::create(ui_layout, layout, parentWidget);
+    if (layoutWidget) {
+        const QFormBuilderStrings &strings = QFormBuilderStrings::instance();
+        int left, top, right, bottom;
+        left = top = right = bottom = 0;
+        const DomPropertyHash properties = propertyMap(ui_layout->elementProperty());
+
+        if (DomProperty *prop = properties.value(strings.leftMarginProperty))
+            left = prop->elementNumber();
+
+        if (DomProperty *prop = properties.value(strings.topMarginProperty))
+            top = prop->elementNumber();
+
+        if (DomProperty *prop = properties.value(strings.rightMarginProperty))
+            right = prop->elementNumber();
+
+        if (DomProperty *prop = properties.value(strings.bottomMarginProperty))
+            bottom = prop->elementNumber();
+
+        l->setContentsMargins(left, top, right, bottom);
+        QFormBuilderExtra::instance(this)->setProcessingLayoutWidget(false);
+    }
+    return l;
+}
+
+/*!
+    \internal
+*/
+QLayoutItem *QFormBuilder::create(DomLayoutItem *ui_layoutItem, QLayout *layout, QWidget *parentWidget)
+{
+    return QAbstractFormBuilder::create(ui_layoutItem, layout, parentWidget);
+}
+
+/*!
+    \internal
+*/
+QAction *QFormBuilder::create(DomAction *ui_action, QObject *parent)
+{
+    return QAbstractFormBuilder::create(ui_action, parent);
+}
+
+/*!
+    \internal
+*/
+QActionGroup *QFormBuilder::create(DomActionGroup *ui_action_group, QObject *parent)
+{
+    return QAbstractFormBuilder::create(ui_action_group, parent);
+}
+
+/*!
+    Returns the list of paths the form builder searches for plugins.
+
+    \sa addPluginPath()
+*/
+QStringList QFormBuilder::pluginPaths() const
+{
+    return m_pluginPaths;
+}
+
+/*!
+    Clears the list of paths that the form builder uses to search for
+    custom widget plugins.
+
+    \sa pluginPaths()
+*/
+void QFormBuilder::clearPluginPaths()
+{
+    m_pluginPaths.clear();
+    updateCustomWidgets();
+}
+
+/*!
+    Adds a new plugin path specified by \a pluginPath to the list of
+    paths that will be searched by the form builder when loading a
+    custom widget plugin.
+
+    \sa setPluginPath(), clearPluginPaths()
+*/
+void QFormBuilder::addPluginPath(const QString &pluginPath)
+{
+    m_pluginPaths.append(pluginPath);
+    updateCustomWidgets();
+}
+
+/*!
+    Sets the list of plugin paths to the list specified by \a pluginPaths.
+
+    \sa addPluginPath()
+*/
+void QFormBuilder::setPluginPath(const QStringList &pluginPaths)
+{
+    m_pluginPaths = pluginPaths;
+    updateCustomWidgets();
+}
+
+static void insertPlugins(QObject *o, QMap<QString, QDesignerCustomWidgetInterface*> *customWidgets)
+{
+    // step 1) try with a normal plugin
+    if (QDesignerCustomWidgetInterface *iface = qobject_cast<QDesignerCustomWidgetInterface *>(o)) {
+        customWidgets->insert(iface->name(), iface);
+        return;
+    }
+    // step 2) try with a collection of plugins
+    if (QDesignerCustomWidgetCollectionInterface *c = qobject_cast<QDesignerCustomWidgetCollectionInterface *>(o)) {
+        foreach (QDesignerCustomWidgetInterface *iface, c->customWidgets())
+            customWidgets->insert(iface->name(), iface);
+    }
+}
+
+/*!
+    \internal
+*/
+void QFormBuilder::updateCustomWidgets()
+{
+    m_customWidgets.clear();
+
+    foreach (QString path, m_pluginPaths) {
+        const QDir dir(path);
+        const QStringList candidates = dir.entryList(QDir::Files);
+
+        foreach (const QString &plugin, candidates) {
+            if (!QLibrary::isLibrary(plugin))
+                continue;
+
+            QString loaderPath = path;
+            loaderPath += QLatin1Char('/');
+            loaderPath += plugin;
+
+            QPluginLoader loader(loaderPath);
+            if (loader.load())
+                insertPlugins(loader.instance(), &m_customWidgets);
+        }
+    }
+    // Check statically linked plugins
+    const QObjectList staticPlugins = QPluginLoader::staticInstances();
+    if (!staticPlugins.empty())
+        foreach (QObject *o, staticPlugins)
+            insertPlugins(o, &m_customWidgets);
+}
+
+/*!
+    \fn QList<QDesignerCustomWidgetInterface*> QFormBuilder::customWidgets() const
+
+    Returns a list of the available plugins.
+*/
+QList<QDesignerCustomWidgetInterface*> QFormBuilder::customWidgets() const
+{
+    return m_customWidgets.values();
+}
+
+/*!
+    \internal
+*/
+void QFormBuilder::applyProperties(QObject *o, const QList<DomProperty*> &properties)
+{
+    typedef QList<DomProperty*> DomPropertyList;
+
+    if (properties.empty())
+        return;
+
+    QFormBuilderExtra *fb = QFormBuilderExtra::instance(this);
+    const QFormBuilderStrings &strings = QFormBuilderStrings::instance();
+
+    const DomPropertyList::const_iterator cend = properties.constEnd();
+    for (DomPropertyList::const_iterator it = properties.constBegin(); it != cend; ++it) {
+        const QVariant v = toVariant(o->metaObject(), *it);
+        if (v.isNull())
+            continue;
+
+        const QString attributeName = (*it)->attributeName();
+        if (o == fb->rootWidget() && attributeName == strings.geometryProperty) {
+            // apply only the size for the rootWidget
+            fb->rootWidget()->resize(qvariant_cast<QRect>(v).size());
+        } else if (fb->applyPropertyInternally(o, attributeName, v)) {
+        } else if (!qstrcmp("QFrame", o->metaObject()->className ()) && attributeName == strings.orientationProperty) {
+            // ### special-casing for Line (QFrame) -- try to fix me
+            o->setProperty("frameShape", v); // v is of QFrame::Shape enum
+        } else {
+            o->setProperty(attributeName.toUtf8(), v);
+        }
+    }
+}
+
+#ifdef QFORMINTERNAL_NAMESPACE
+} // namespace QFormInternal
+#endif
+
+QT_END_NAMESPACE