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//
30// W A R N I N G
31// -------------
32//
33// This file is not part of the Qt API. It exists for the convenience
34// of Qt Designer. This header
35// file may change from version to version without notice, or even be removed.
36//
37// We mean it.
38//
39
40
41#ifndef DESIGNERPROPERTYEDITOR_H
42#define DESIGNERPROPERTYEDITOR_H
43
44#include "shared_global_p.h"
45#include "shared_enums_p.h"
46#include <QtDesigner/abstractpropertyeditor.h>
47
48QT_BEGIN_NAMESPACE
49
50namespace qdesigner_internal {
51
52// Extends the QDesignerPropertyEditorInterface by property comment handling and
53// a signal for resetproperty.
54
55class QDESIGNER_SHARED_EXPORT QDesignerPropertyEditor: public QDesignerPropertyEditorInterface
56{
57 Q_OBJECT
58public:
59 explicit QDesignerPropertyEditor(QWidget *parent = nullptr, Qt::WindowFlags flags = {});
60
61 // A pair <ValidationMode, bool isTranslatable>.
62 using StringPropertyParameters = QPair<TextPropertyValidationMode, bool>;
63
64 // Return a pair of validation mode and flag indicating whether property is translatable
65 // for textual properties.
66 static StringPropertyParameters textPropertyValidationMode(QDesignerFormEditorInterface *core,
67 const QObject *object, const QString &propertyName, bool isMainContainer);
68
69Q_SIGNALS:
70 void propertyValueChanged(const QString &name, const QVariant &value, bool enableSubPropertyHandling);
71 void resetProperty(const QString &name);
72 void addDynamicProperty(const QString &name, const QVariant &value);
73 void removeDynamicProperty(const QString &name);
74 void editorOpened();
75 void editorClosed();
76
77public Q_SLOTS:
78 /* Quick update that assumes the actual count of properties has not changed
79 * (as opposed to setObject()). N/A when for example executing a
80 * layout command and margin properties appear. */
81 virtual void updatePropertySheet() = 0;
82 virtual void reloadResourceProperties() = 0;
83
84private Q_SLOTS:
85 void slotPropertyChanged(const QString &name, const QVariant &value);
86
87protected:
88 void emitPropertyValueChanged(const QString &name, const QVariant &value, bool enableSubPropertyHandling);
89
90private:
91 bool m_propertyChangedForwardingBlocked = false;
92
93};
94
95} // namespace qdesigner_internal
96
97QT_END_NAMESPACE
98
99#endif // DESIGNERPROPERTYEDITOR_H
100

source code of qttools/src/designer/src/lib/shared/qdesigner_propertyeditor_p.h