1/****************************************************************************
2**
3** Copyright (C) 2016 The Qt Company Ltd.
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the Qt Designer of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:GPL-EXCEPT$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see https://www.qt.io/terms-conditions. For further
15** information use the contact form at https://www.qt.io/contact-us.
16**
17** GNU General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU
19** General Public License version 3 as published by the Free Software
20** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT
21** included in the packaging of this file. Please review the following
22** information to ensure the GNU General Public License requirements will
23** be met: https://www.gnu.org/licenses/gpl-3.0.html.
24**
25** $QT_END_LICENSE$
26**
27****************************************************************************/
28
29#ifndef ABSTRACTWIDGETBOX_H
30#define ABSTRACTWIDGETBOX_H
31
32#include <QtDesigner/sdk_global.h>
33
34#include <QtCore/qshareddata.h>
35#include <QtCore/qmetatype.h>
36#include <QtWidgets/qwidget.h>
37#include <QtGui/qicon.h>
38
39QT_BEGIN_NAMESPACE
40
41class DomUI;
42class QDesignerDnDItemInterface;
43
44class QDesignerWidgetBoxWidgetData;
45
46class QDESIGNER_SDK_EXPORT QDesignerWidgetBoxInterface : public QWidget
47{
48 Q_OBJECT
49public:
50 class QDESIGNER_SDK_EXPORT Widget {
51 public:
52 enum Type { Default, Custom };
53 Widget(const QString &aname = QString(), const QString &xml = QString(),
54 const QString &icon_name = QString(), Type atype = Default);
55 ~Widget();
56 Widget(const Widget &w);
57 Widget &operator=(const Widget &w);
58
59 QString name() const;
60 void setName(const QString &aname);
61 QString domXml() const;
62 void setDomXml(const QString &xml);
63 QString iconName() const;
64 void setIconName(const QString &icon_name);
65 Type type() const;
66 void setType(Type atype);
67
68 bool isNull() const;
69
70 private:
71 QSharedDataPointer<QDesignerWidgetBoxWidgetData> m_data;
72 };
73
74#if QT_VERSION < QT_VERSION_CHECK(6,0,0)
75 using WidgetList = QList<Widget>;
76#endif
77
78 class Category {
79 public:
80 enum Type { Default, Scratchpad };
81
82 Category(const QString &aname = QString(), Type atype = Default)
83 : m_name(aname), m_type(atype) {}
84
85 QString name() const { return m_name; }
86 void setName(const QString &aname) { m_name = aname; }
87 int widgetCount() const { return m_widget_list.size(); }
88 Widget widget(int idx) const { return m_widget_list.at(i: idx); }
89 void removeWidget(int idx) { m_widget_list.removeAt(i: idx); }
90 void addWidget(const Widget &awidget) { m_widget_list.append(t: awidget); }
91 Type type() const { return m_type; }
92 void setType(Type atype) { m_type = atype; }
93
94 bool isNull() const { return m_name.isEmpty(); }
95
96 private:
97 QString m_name;
98 Type m_type;
99 QList<Widget> m_widget_list;
100 };
101 using CategoryList = QList<Category>;
102
103 explicit QDesignerWidgetBoxInterface(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags());
104 virtual ~QDesignerWidgetBoxInterface();
105
106 virtual int categoryCount() const = 0;
107 virtual Category category(int cat_idx) const = 0;
108 virtual void addCategory(const Category &cat) = 0;
109 virtual void removeCategory(int cat_idx) = 0;
110
111 virtual int widgetCount(int cat_idx) const = 0;
112 virtual Widget widget(int cat_idx, int wgt_idx) const = 0;
113 virtual void addWidget(int cat_idx, const Widget &wgt) = 0;
114 virtual void removeWidget(int cat_idx, int wgt_idx) = 0;
115
116 int findOrInsertCategory(const QString &categoryName);
117
118 virtual void dropWidgets(const QList<QDesignerDnDItemInterface*> &item_list,
119 const QPoint &global_mouse_pos) = 0;
120
121 virtual void setFileName(const QString &file_name) = 0;
122 virtual QString fileName() const = 0;
123 virtual bool load() = 0;
124 virtual bool save() = 0;
125};
126
127QT_END_NAMESPACE
128
129Q_DECLARE_METATYPE(QT_PREPEND_NAMESPACE(QDesignerWidgetBoxInterface::Widget))
130
131#endif // ABSTRACTWIDGETBOX_H
132

source code of qttools/src/designer/src/lib/sdk/abstractwidgetbox.h