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 48 QT_BEGIN_NAMESPACE stringPropertyTypes()49 50 namespace qdesigner_internal { 51 52 // Extends the QDesignerPropertyEditorInterface by property comment handling and 53 // a signal for resetproperty. 54 55 class QDESIGNER_SHARED_EXPORT QDesignerPropertyEditor: public QDesignerPropertyEditorInterface 56 { 57 Q_OBJECT 58 public: 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 69 Q_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 77 public 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 84 private Q_SLOTS: 85 void slotPropertyChanged(const QString &name, const QVariant &value); 86 87 protected: 88 void emitPropertyValueChanged(const QString &name, const QVariant &value, bool enableSubPropertyHandling); 89 90 private: 91 bool m_propertyChangedForwardingBlocked = false; 92 93 }; 94 95 } // namespace qdesigner_internal 96 97 QT_END_NAMESPACE 98 99 #endif // DESIGNERPROPERTYEDITOR_H 100