qt5base-lts/tools/uilib/abstractformbuilder.h
Jyri Tahtela f9f395c28b Update licenseheader text in source files for qtbase Qt module
Updated version of LGPL and FDL licenseheaders.
Apply release phase licenseheaders for all source files.

Reviewed-by: Trust Me
2011-05-24 12:34:08 +03:00

284 lines
10 KiB
C++

/****************************************************************************
**
** 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 Qt Designer of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** GNU Lesser General Public License Usage
** 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.
**
** Other Usage
** Alternatively, this file may be used in accordance with the terms and
** conditions contained in a signed written agreement between you and Nokia.
**
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
#ifndef ABSTRACTFORMBUILDER_H
#define ABSTRACTFORMBUILDER_H
#include "uilib_global.h"
#include <QtCore/QList>
#include <QtCore/QHash>
#include <QtCore/QDir>
#include <QtCore/QScopedPointer>
#include <QtGui/QSizePolicy>
#include <QtGui/QPalette>
QT_BEGIN_HEADER
QT_BEGIN_NAMESPACE
#if 0
// pragma for syncqt, don't remove.
#pragma qt_class(QAbstractFormBuilder)
#endif
class QAction;
class QButtonGroup;
class QActionGroup;
class QComboBox;
class QIODevice;
class QIcon;
class QLayout;
class QLayoutItem;
class QListWidget;
class QObject;
class QSpacerItem;
class QTreeWidget;
class QTableWidget;
class QVariant;
class QWidget;
class QAbstractButton;
class QAbstractItemView;
#ifdef QFORMINTERNAL_NAMESPACE
namespace QFormInternal
{
#endif
class DomAction;
class DomActionGroup;
class DomButtonGroup;
class DomButtonGroups;
class DomActionRef;
class DomBrush;
class DomColorGroup;
class DomConnections;
class DomCustomWidgets;
class DomLayout;
class DomLayoutItem;
class DomProperty;
class DomResources;
class DomSpacer;
class DomString;
class DomTabStops;
class DomUI;
class DomWidget;
class DomResourcePixmap;
class QResourceBuilder;
class QTextBuilder;
class QFormBuilderExtra;
#ifndef QT_FORMBUILDER_NO_SCRIPT
class QFormScriptRunner;
#endif
class QDESIGNER_UILIB_EXPORT QAbstractFormBuilder
{
public:
QAbstractFormBuilder();
virtual ~QAbstractFormBuilder();
QDir workingDirectory() const;
void setWorkingDirectory(const QDir &directory);
virtual QWidget *load(QIODevice *dev, QWidget *parentWidget=0);
virtual void save(QIODevice *dev, QWidget *widget);
void setScriptingEnabled(bool enabled);
bool isScriptingEnabled() const;
QString errorString() const;
protected:
//
// load
//
virtual void loadExtraInfo(DomWidget *ui_widget, QWidget *widget, QWidget *parentWidget);
virtual QWidget *create(DomUI *ui, QWidget *parentWidget);
virtual QWidget *create(DomWidget *ui_widget, QWidget *parentWidget);
virtual QLayout *create(DomLayout *ui_layout, QLayout *layout, QWidget *parentWidget);
virtual QLayoutItem *create(DomLayoutItem *ui_layoutItem, QLayout *layout, QWidget *parentWidget);
virtual QAction *create(DomAction *ui_action, QObject *parent);
virtual QActionGroup *create(DomActionGroup *ui_action_group, QObject *parent);
virtual void addMenuAction(QAction *action);
virtual void applyProperties(QObject *o, const QList<DomProperty*> &properties);
bool applyPropertyInternally(QObject *o, const QString &propertyName, const QVariant &value);
virtual void applyTabStops(QWidget *widget, DomTabStops *tabStops);
virtual QWidget *createWidget(const QString &widgetName, QWidget *parentWidget, const QString &name);
virtual QLayout *createLayout(const QString &layoutName, QObject *parent, const QString &name);
virtual QAction *createAction(QObject *parent, const QString &name);
virtual QActionGroup *createActionGroup(QObject *parent, const QString &name);
virtual void createCustomWidgets(DomCustomWidgets *) {}
virtual void createConnections(DomConnections *, QWidget *) {}
virtual void createResources(DomResources*) {}
virtual bool addItem(DomLayoutItem *ui_item, QLayoutItem *item, QLayout *layout);
virtual bool addItem(DomWidget *ui_widget, QWidget *widget, QWidget *parentWidget);
//
// save
//
virtual void saveExtraInfo(QWidget *widget, DomWidget *ui_widget, DomWidget *ui_parentWidget);
virtual void saveDom(DomUI *ui, QWidget *widget);
virtual DomActionRef *createActionRefDom(QAction *action);
virtual DomWidget *createDom(QWidget *widget, DomWidget *ui_parentWidget, bool recursive = true);
virtual DomLayout *createDom(QLayout *layout, DomLayout *ui_layout, DomWidget *ui_parentWidget);
virtual DomLayoutItem *createDom(QLayoutItem *item, DomLayout *ui_parentLayout, DomWidget *ui_parentWidget);
virtual DomSpacer *createDom(QSpacerItem *spacer, DomLayout *ui_parentLayout, DomWidget *ui_parentWidget);
virtual DomAction *createDom(QAction *action);
virtual DomActionGroup *createDom(QActionGroup *actionGroup);
DomButtonGroup *createDom(QButtonGroup *buttonGroup);
virtual DomConnections *saveConnections();
virtual DomCustomWidgets *saveCustomWidgets();
virtual DomTabStops *saveTabStops();
virtual DomResources *saveResources();
DomButtonGroups *saveButtonGroups(const QWidget *mainContainer);
virtual QList<DomProperty*> computeProperties(QObject *obj);
virtual bool checkProperty(QObject *obj, const QString &prop) const;
virtual DomProperty *createProperty(QObject *object, const QString &propertyName, const QVariant &value);
virtual void layoutInfo(DomLayout *layout, QObject *parent, int *margin, int *spacing);
void loadListWidgetExtraInfo(DomWidget *ui_widget, QListWidget *listWidget, QWidget *parentWidget);
void loadTreeWidgetExtraInfo(DomWidget *ui_widget, QTreeWidget *treeWidget, QWidget *parentWidget);
void loadTableWidgetExtraInfo(DomWidget *ui_widget, QTableWidget *tableWidget, QWidget *parentWidget);
void loadComboBoxExtraInfo(DomWidget *ui_widget, QComboBox *comboBox, QWidget *parentWidget);
void loadButtonExtraInfo(const DomWidget *ui_widget, QAbstractButton *button, QWidget *parentWidget);
void loadItemViewExtraInfo(DomWidget *ui_widget, QAbstractItemView *itemView, QWidget *parentWidget);
void saveListWidgetExtraInfo(QListWidget *widget, DomWidget *ui_widget, DomWidget *ui_parentWidget);
void saveTreeWidgetExtraInfo(QTreeWidget *treeWidget, DomWidget *ui_widget, DomWidget *ui_parentWidget);
void saveTableWidgetExtraInfo(QTableWidget *tablWidget, DomWidget *ui_widget, DomWidget *ui_parentWidget);
void saveComboBoxExtraInfo(QComboBox *widget, DomWidget *ui_widget, DomWidget *ui_parentWidget);
void saveButtonExtraInfo(const QAbstractButton *widget, DomWidget *ui_widget, DomWidget *ui_parentWidget);
void saveItemViewExtraInfo(const QAbstractItemView *itemView, DomWidget *ui_widget, DomWidget *ui_parentWidget);
void setResourceBuilder(QResourceBuilder *builder);
QResourceBuilder *resourceBuilder() const;
DomProperty *saveResource(const QVariant &v) const;
void setTextBuilder(QTextBuilder *builder);
QTextBuilder *textBuilder() const;
DomProperty *saveText(const QString &attributeName, const QVariant &v) const;
//
// utils
//
QVariant toVariant(const QMetaObject *meta, DomProperty *property);
static QString toString(const DomString *str);
typedef QHash<QString, DomProperty*> DomPropertyHash;
static DomPropertyHash propertyMap(const QList<DomProperty*> &properties);
void setupColorGroup(QPalette &palette, QPalette::ColorGroup colorGroup, DomColorGroup *group);
DomColorGroup *saveColorGroup(const QPalette &palette);
QBrush setupBrush(DomBrush *brush);
DomBrush *saveBrush(const QBrush &brush);
void reset();
void initialize(const DomUI *ui);
#ifndef QT_FORMBUILDER_NO_SCRIPT
QFormScriptRunner *formScriptRunner() const;
#endif
//
// utils
//
static QMetaEnum toolBarAreaMetaEnum();
//
// Icon/pixmap stuff
//
// A Pair of icon path/qrc path.
typedef QPair<QString, QString> IconPaths;
IconPaths iconPaths(const QIcon &) const;
IconPaths pixmapPaths(const QPixmap &) const;
void setIconProperty(DomProperty &, const IconPaths &) const;
void setPixmapProperty(DomProperty &, const IconPaths &) const;
DomProperty* iconToDomProperty(const QIcon &) const;
static const DomResourcePixmap *domPixmap(const DomProperty* p);
QIcon domPropertyToIcon(const DomResourcePixmap *);
QIcon domPropertyToIcon(const DomProperty* p);
QPixmap domPropertyToPixmap(const DomResourcePixmap* p);
QPixmap domPropertyToPixmap(const DomProperty* p);
private:
//
// utils
//
static Qt::ToolBarArea toolbarAreaFromDOMAttributes(const DomPropertyHash &attributeMap);
QAbstractFormBuilder(const QAbstractFormBuilder &other);
void operator = (const QAbstractFormBuilder &other);
friend QDESIGNER_UILIB_EXPORT DomProperty *variantToDomProperty(QAbstractFormBuilder *abstractFormBuilder, const QMetaObject *meta, const QString &propertyName, const QVariant &value);
friend QDESIGNER_UILIB_EXPORT QVariant domPropertyToVariant(QAbstractFormBuilder *abstractFormBuilder,const QMetaObject *meta, const DomProperty *property);
protected:
QScopedPointer<QFormBuilderExtra> d;
};
#ifdef QFORMINTERNAL_NAMESPACE
}
#endif
QT_END_NAMESPACE
QT_END_HEADER
#endif // ABSTRACTFORMBUILDER_H