source: trunk/tools/designer/src/lib/uilib/abstractformbuilder.h@ 651

Last change on this file since 651 was 651, checked in by Dmitry A. Kuminov, 15 years ago

trunk: Merged in qt 4.6.2 sources.
File size: 10.7 KB
Line 
1/****************************************************************************
2**
3** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
4** All rights reserved.
5** Contact: Nokia Corporation ([email protected])
6**
7** This file is part of the Qt Designer of the Qt Toolkit.
8**
9** $QT_BEGIN_LICENSE:LGPL$
10** Commercial Usage
11** Licensees holding valid Qt Commercial licenses may use this file in
12** accordance with the Qt Commercial License Agreement provided with the
13** Software or, alternatively, in accordance with the terms contained in
14** a written agreement between you and Nokia.
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** GNU General Public License Usage
29** Alternatively, this file may be used under the terms of the GNU
30** General Public License version 3.0 as published by the Free Software
31** Foundation and appearing in the file LICENSE.GPL included in the
32** packaging of this file. Please review the following information to
33** ensure the GNU General Public License version 3.0 requirements will be
34** met: http://www.gnu.org/copyleft/gpl.html.
35**
36** If you have questions regarding the use of this file, please contact
37** Nokia at [email protected].
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
54QT_BEGIN_HEADER
55
56QT_BEGIN_NAMESPACE
57#if 0
58// pragma for syncqt, don't remove.
59
60#pragma qt_class(QAbstractFormBuilder)
61#endif
62
63class QAction;
64class QButtonGroup;
65class QActionGroup;
66class QComboBox;
67class QIODevice;
68class QIcon;
69class QLayout;
70class QLayoutItem;
71class QListWidget;
72class QObject;
73class QSpacerItem;
74class QTreeWidget;
75class QTableWidget;
76class QVariant;
77class QWidget;
78class QAbstractButton;
79class QAbstractItemView;
80
81#ifdef QFORMINTERNAL_NAMESPACE
82namespace QFormInternal
83{
84#endif
85
86class DomAction;
87class DomActionGroup;
88class DomButtonGroup;
89class DomButtonGroups;
90class DomActionRef;
91class DomBrush;
92class DomColorGroup;
93class DomConnections;
94class DomCustomWidgets;
95class DomLayout;
96class DomLayoutItem;
97class DomProperty;
98class DomResources;
99class DomSpacer;
100class DomString;
101class DomTabStops;
102class DomUI;
103class DomWidget;
104class DomResourcePixmap;
105
106class QResourceBuilder;
107class QTextBuilder;
108
109#ifndef QT_FORMBUILDER_NO_SCRIPT
110class QFormScriptRunner;
111#endif
112
113class QDESIGNER_UILIB_EXPORT QAbstractFormBuilder
114{
115public:
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
128protected:
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
269private:
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
286QT_END_NAMESPACE
287
288QT_END_HEADER
289
290#endif // ABSTRACTFORMBUILDER_H
Note: See TracBrowser for help on using the repository browser.