/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of Qt Creator. ** ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3 as published by the Free Software ** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-3.0.html. ** ****************************************************************************/ #pragma once #include "../projectexplorer_export.h" #include #include #include #include #include QT_BEGIN_NAMESPACE class QFormLayout; class QLabel; class QLineEdit; class QTextEdit; QT_END_NAMESPACE namespace Utils { class MacroExpander; } // namespace Utils namespace ProjectExplorer { // Documentation inside. class PROJECTEXPLORER_EXPORT JsonFieldPage : public Utils::WizardPage { Q_OBJECT public: class PROJECTEXPLORER_EXPORT Field { public: class FieldPrivate; Field(); virtual ~Field(); static Field *parse(const QVariant &input, QString *errorMessage); void createWidget(JsonFieldPage *page); void adjustState(Utils::MacroExpander *expander); virtual void setEnabled(bool e); void setVisible(bool v); void setType(const QString &type); virtual bool validate(Utils::MacroExpander *expander, QString *message); void initialize(Utils::MacroExpander *expander); virtual void cleanup(Utils::MacroExpander *expander) { Q_UNUSED(expander) } virtual bool suppressName() const { return false; } QWidget *widget(const QString &displayName, JsonFieldPage *page); QString name() const; QString displayName() const; QString toolTip() const; QString persistenceKey() const; bool isMandatory() const; bool hasSpan() const; bool hasUserChanges() const; protected: QWidget *widget() const; virtual bool parseData(const QVariant &data, QString *errorMessage) = 0; virtual void initializeData(Utils::MacroExpander *expander) { Q_UNUSED(expander) } virtual QWidget *createWidget(const QString &displayName, JsonFieldPage *page) = 0; virtual void setup(JsonFieldPage *page, const QString &name) { Q_UNUSED(page); Q_UNUSED(name) } QString type() const; void setHasUserChanges(); private: virtual void fromSettings(const QVariant &value); virtual QVariant toSettings() const; void setTexts(const QString &name, const QString &displayName, const QString &toolTip); void setIsMandatory(bool b); void setHasSpan(bool b); void setVisibleExpression(const QVariant &v); void setEnabledExpression(const QVariant &v); void setIsCompleteExpando(const QVariant &v, const QString &m); void setPersistenceKey(const QString &key); virtual QString toString() const = 0; friend class JsonFieldPage; friend PROJECTEXPLORER_EXPORT QDebug &operator<<(QDebug &d, const Field &f); const std::unique_ptr d; }; JsonFieldPage(Utils::MacroExpander *expander, QWidget *parent = nullptr); ~JsonFieldPage() override; using FieldFactory = std::function; static void registerFieldFactory(const QString &id, const FieldFactory &ff); bool setup(const QVariant &data); bool isComplete() const override; void initializePage() override; void cleanupPage() override; bool validatePage() override; QFormLayout *layout() const { return m_formLayout; } void showError(const QString &m) const; void clearError() const; Utils::MacroExpander *expander(); QVariant value(const QString &key); public: Field *jsonField(const QString &name); private: static QHash m_factories; static Field *createFieldData(const QString &type); static QString fullSettingsKey(const QString &fieldKey); QFormLayout *m_formLayout; QLabel *m_errorLabel; QList m_fields; Utils::MacroExpander *m_expander; }; PROJECTEXPLORER_EXPORT QDebug &operator<<(QDebug &debug, const JsonFieldPage::Field &field); } // namespace ProjectExplorer