1 /****************************************************************************

     2 **

     3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

     4 ** All rights reserved.

     5 ** Contact: Nokia Corporation (qt-info@nokia.com)

     6 **

     7 ** This file is part of the Qt Designer of the Qt Toolkit.

     8 **

     9 ** $QT_BEGIN_LICENSE:LGPL$

    10 ** No Commercial Usage

    11 ** This file contains pre-release code and may not be distributed.

    12 ** You may use this file in accordance with the terms and conditions

    13 ** contained in the Technology Preview License Agreement accompanying

    14 ** this package.

    15 **

    16 ** GNU Lesser General Public License Usage

    17 ** Alternatively, this file may be used under the terms of the GNU Lesser

    18 ** General Public License version 2.1 as published by the Free Software

    19 ** Foundation and appearing in the file LICENSE.LGPL included in the

    20 ** packaging of this file.  Please review the following information to

    21 ** ensure the GNU Lesser General Public License version 2.1 requirements

    22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

    23 **

    24 ** In addition, as a special exception, Nokia gives you certain additional

    25 ** rights.  These rights are described in the Nokia Qt LGPL Exception

    26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

    27 **

    28 ** If you have questions regarding the use of this file, please contact

    29 ** Nokia at qt-info@nokia.com.

    30 **

    31 **

    32 **

    33 **

    34 **

    35 **

    36 **

    37 **

    38 ** $QT_END_LICENSE$

    39 **

    40 ****************************************************************************/

    41 

    42 #ifndef ABSTRACTFORMBUILDER_H

    43 #define ABSTRACTFORMBUILDER_H

    44 

    45 #include <QtDesigner/uilib_global.h>

    46 

    47 #include <QtCore/QList>

    48 #include <QtCore/QHash>

    49 #include <QtCore/QDir>

    50 

    51 #include <QtGui/QSizePolicy>

    52 #include <QtGui/QPalette>

    53 

    54 QT_BEGIN_HEADER

    55 

    56 QT_BEGIN_NAMESPACE

    57 #if 0

    58 // pragma for syncqt, don't remove.

    59 

    60 #pragma qt_class(QAbstractFormBuilder)

    61 #endif

    62 

    63 class QAction;

    64 class QButtonGroup;

    65 class QActionGroup;

    66 class QComboBox;

    67 class QIODevice;

    68 class QIcon;

    69 class QLayout;

    70 class QLayoutItem;

    71 class QListWidget;

    72 class QObject;

    73 class QSpacerItem;

    74 class QTreeWidget;

    75 class QTableWidget;

    76 class QVariant;

    77 class QWidget;

    78 class QAbstractButton;

    79 class QAbstractItemView;

    80 

    81 #ifdef QFORMINTERNAL_NAMESPACE

    82 namespace QFormInternal

    83 {

    84 #endif

    85 

    86 class DomAction;

    87 class DomActionGroup;

    88 class DomButtonGroup;

    89 class DomButtonGroups;

    90 class DomActionRef;

    91 class DomBrush;

    92 class DomColorGroup;

    93 class DomConnections;

    94 class DomCustomWidgets;

    95 class DomLayout;

    96 class DomLayoutItem;

    97 class DomProperty;

    98 class DomResources;

    99 class DomSpacer;

   100 class DomString;

   101 class DomTabStops;

   102 class DomUI;

   103 class DomWidget;

   104 class DomResourcePixmap;

   105 

   106 class QResourceBuilder;

   107 class QTextBuilder;

   108 

   109 #ifndef QT_FORMBUILDER_NO_SCRIPT

   110 class QFormScriptRunner;

   111 #endif

   112 

   113 class QDESIGNER_UILIB_EXPORT QAbstractFormBuilder

   114 {

   115 public:

   116     QAbstractFormBuilder();

   117     virtual ~QAbstractFormBuilder();

   118 

   119     QDir workingDirectory() const;

   120     void setWorkingDirectory(const QDir &directory);

   121 

   122     virtual QWidget *load(QIODevice *dev, QWidget *parentWidget=0);

   123     virtual void save(QIODevice *dev, QWidget *widget);

   124 

   125     void setScriptingEnabled(bool enabled);

   126     bool isScriptingEnabled() const;

   127 

   128 protected:

   129 //

   130 // load

   131 //

   132     virtual void loadExtraInfo(DomWidget *ui_widget, QWidget *widget, QWidget *parentWidget);

   133 

   134     virtual QWidget *create(DomUI *ui, QWidget *parentWidget);

   135     virtual QWidget *create(DomWidget *ui_widget, QWidget *parentWidget);

   136     virtual QLayout *create(DomLayout *ui_layout, QLayout *layout, QWidget *parentWidget);

   137     virtual QLayoutItem *create(DomLayoutItem *ui_layoutItem, QLayout *layout, QWidget *parentWidget);

   138 

   139     virtual QAction *create(DomAction *ui_action, QObject *parent);

   140     virtual QActionGroup *create(DomActionGroup *ui_action_group, QObject *parent);

   141     virtual void addMenuAction(QAction *action);

   142 

   143     virtual void applyProperties(QObject *o, const QList<DomProperty*> &properties);

   144     bool applyPropertyInternally(QObject *o, const QString &propertyName, const QVariant &value);

   145 

   146     virtual void applyTabStops(QWidget *widget, DomTabStops *tabStops);

   147 

   148     virtual QWidget *createWidget(const QString &widgetName, QWidget *parentWidget, const QString &name);

   149     virtual QLayout *createLayout(const QString &layoutName, QObject *parent, const QString &name);

   150     virtual QAction *createAction(QObject *parent, const QString &name);

   151     virtual QActionGroup *createActionGroup(QObject *parent, const QString &name);

   152 

   153     virtual void createCustomWidgets(DomCustomWidgets *) {}

   154     virtual void createConnections(DomConnections *, QWidget *) {}

   155     virtual void createResources(DomResources*) {}

   156 

   157     virtual bool addItem(DomLayoutItem *ui_item, QLayoutItem *item, QLayout *layout);

   158     virtual bool addItem(DomWidget *ui_widget, QWidget *widget, QWidget *parentWidget);

   159 

   160 //

   161 // save

   162 //

   163     virtual void saveExtraInfo(QWidget *widget, DomWidget *ui_widget, DomWidget *ui_parentWidget);

   164 

   165     virtual void saveDom(DomUI *ui, QWidget *widget);

   166 

   167     virtual DomActionRef *createActionRefDom(QAction *action);

   168 

   169     virtual DomWidget *createDom(QWidget *widget, DomWidget *ui_parentWidget, bool recursive = true);

   170     virtual DomLayout *createDom(QLayout *layout, DomLayout *ui_layout, DomWidget *ui_parentWidget);

   171     virtual DomLayoutItem *createDom(QLayoutItem *item, DomLayout *ui_parentLayout, DomWidget *ui_parentWidget);

   172     virtual DomSpacer *createDom(QSpacerItem *spacer, DomLayout *ui_parentLayout, DomWidget *ui_parentWidget);

   173 

   174     virtual DomAction *createDom(QAction *action);

   175     virtual DomActionGroup *createDom(QActionGroup *actionGroup);

   176     DomButtonGroup *createDom(QButtonGroup *buttonGroup);

   177 

   178     virtual DomConnections *saveConnections();

   179     virtual DomCustomWidgets *saveCustomWidgets();

   180     virtual DomTabStops *saveTabStops();

   181     virtual DomResources *saveResources();

   182     DomButtonGroups *saveButtonGroups(const QWidget *mainContainer);

   183     virtual QList<DomProperty*> computeProperties(QObject *obj);

   184     virtual bool checkProperty(QObject *obj, const QString &prop) const;

   185     virtual DomProperty *createProperty(QObject *object, const QString &propertyName, const QVariant &value);

   186 

   187     virtual void layoutInfo(DomLayout *layout, QObject *parent, int *margin, int *spacing);

   188 

   189     virtual QIcon nameToIcon(const QString &filePath, const QString &qrcPath);

   190     virtual QString iconToFilePath(const QIcon &pm) const;

   191     virtual QString iconToQrcPath(const QIcon &pm) const;

   192     virtual QPixmap nameToPixmap(const QString &filePath, const QString &qrcPath);

   193     virtual QString pixmapToFilePath(const QPixmap &pm) const;

   194     virtual QString pixmapToQrcPath(const QPixmap &pm) const;

   195 

   196     void loadListWidgetExtraInfo(DomWidget *ui_widget, QListWidget *listWidget, QWidget *parentWidget);

   197     void loadTreeWidgetExtraInfo(DomWidget *ui_widget, QTreeWidget *treeWidget, QWidget *parentWidget);

   198     void loadTableWidgetExtraInfo(DomWidget *ui_widget, QTableWidget *tableWidget, QWidget *parentWidget);

   199     void loadComboBoxExtraInfo(DomWidget *ui_widget, QComboBox *comboBox, QWidget *parentWidget);

   200     void loadButtonExtraInfo(const DomWidget *ui_widget, QAbstractButton *button, QWidget *parentWidget);

   201     void loadItemViewExtraInfo(DomWidget *ui_widget, QAbstractItemView *itemView, QWidget *parentWidget);

   202 

   203     void saveListWidgetExtraInfo(QListWidget *widget, DomWidget *ui_widget, DomWidget *ui_parentWidget);

   204     void saveTreeWidgetExtraInfo(QTreeWidget *treeWidget, DomWidget *ui_widget, DomWidget *ui_parentWidget);

   205     void saveTableWidgetExtraInfo(QTableWidget *tablWidget, DomWidget *ui_widget, DomWidget *ui_parentWidget);

   206     void saveComboBoxExtraInfo(QComboBox *widget, DomWidget *ui_widget, DomWidget *ui_parentWidget);

   207     void saveButtonExtraInfo(const QAbstractButton *widget, DomWidget *ui_widget, DomWidget *ui_parentWidget);

   208     void saveItemViewExtraInfo(const QAbstractItemView *itemView, DomWidget *ui_widget, DomWidget *ui_parentWidget);

   209 

   210     void setResourceBuilder(QResourceBuilder *builder);

   211     QResourceBuilder *resourceBuilder() const;

   212     DomProperty *saveResource(const QVariant &v) const;

   213 

   214     void setTextBuilder(QTextBuilder *builder);

   215     QTextBuilder *textBuilder() const;

   216     DomProperty *saveText(const QString &attributeName, const QVariant &v) const;

   217 //

   218 // utils

   219 //

   220 

   221     QVariant toVariant(const QMetaObject *meta, DomProperty *property);

   222     static QString toString(const DomString *str);

   223 

   224     typedef QHash<QString, DomProperty*> DomPropertyHash;

   225     static DomPropertyHash propertyMap(const QList<DomProperty*> &properties);

   226 

   227     void setupColorGroup(QPalette &palette, QPalette::ColorGroup colorGroup, DomColorGroup *group);

   228     DomColorGroup *saveColorGroup(const QPalette &palette);

   229     QBrush setupBrush(DomBrush *brush);

   230     DomBrush *saveBrush(const QBrush &brush);

   231 

   232     void reset();

   233     void initialize(const DomUI *ui);

   234 

   235 #ifndef QT_FORMBUILDER_NO_SCRIPT

   236     QFormScriptRunner *formScriptRunner() const;

   237 #endif

   238 //

   239 //  utils

   240 //

   241 

   242     static QMetaEnum toolBarAreaMetaEnum();

   243 

   244 //

   245 //  Icon/pixmap stuff

   246 //

   247     // A Pair of icon path/qrc path.

   248     typedef QPair<QString, QString> IconPaths;

   249 

   250     IconPaths iconPaths(const QIcon &) const;

   251     IconPaths pixmapPaths(const QPixmap &) const;

   252     void setIconProperty(DomProperty &, const IconPaths &) const;

   253     void setPixmapProperty(DomProperty &, const IconPaths &) const;

   254     DomProperty* iconToDomProperty(const QIcon &) const;

   255 

   256     static const DomResourcePixmap *domPixmap(const DomProperty* p);

   257     QIcon domPropertyToIcon(const DomResourcePixmap *);

   258     QIcon domPropertyToIcon(const DomProperty* p);

   259     QPixmap domPropertyToPixmap(const DomResourcePixmap* p);

   260     QPixmap domPropertyToPixmap(const DomProperty* p);

   261 

   262     QHash<QObject*, bool> m_laidout;

   263     QHash<QString, QAction*> m_actions;

   264     QHash<QString, QActionGroup*> m_actionGroups;

   265     int m_defaultMargin;

   266     int m_defaultSpacing;

   267     QDir m_workingDirectory;

   268 

   269 private:

   270 //

   271 //  utils

   272 //

   273     static Qt::ToolBarArea toolbarAreaFromDOMAttributes(const DomPropertyHash &attributeMap);

   274 

   275     QAbstractFormBuilder(const QAbstractFormBuilder &other);

   276     void operator = (const QAbstractFormBuilder &other);

   277 

   278     friend QDESIGNER_UILIB_EXPORT DomProperty *variantToDomProperty(QAbstractFormBuilder *abstractFormBuilder, const QMetaObject *meta, const QString &propertyName, const QVariant &value);

   279     friend QDESIGNER_UILIB_EXPORT QVariant domPropertyToVariant(QAbstractFormBuilder *abstractFormBuilder,const QMetaObject *meta, const DomProperty *property);

   280 };

   281 

   282 #ifdef QFORMINTERNAL_NAMESPACE

   283 }

   284 #endif

   285 

   286 QT_END_NAMESPACE

   287 

   288 QT_END_HEADER

   289 

   290 #endif // ABSTRACTFORMBUILDER_H