/*
    SPDX-FileCopyrightText: 2006-2010 Tony Bloomfield <tonybloom@users.sourceforge.net>
    SPDX-FileCopyrightText: 2017 Łukasz Wojniłowicz <lukasz.wojnilowicz@gmail.com>
    SPDX-License-Identifier: GPL-2.0-or-later
*/

#ifndef KGUIUTILS_H
#define KGUIUTILS_H

// ----------------------------------------------------------------------------
// QT Includes

#include <QObject>

// ----------------------------------------------------------------------------
// KDE Includes

// ----------------------------------------------------------------------------
// Project Includes

#include "kmm_widgets_export.h"

class QWidget;
class QPushButton;

/**
  * @author Tony Bloomfield
  */
class KMandatoryFieldGroupPrivate;
class KMM_WIDGETS_EXPORT KMandatoryFieldGroup : public QObject
{
    Q_OBJECT
    Q_DISABLE_COPY(KMandatoryFieldGroup)

public:
    explicit KMandatoryFieldGroup(QObject *parent);
    ~KMandatoryFieldGroup();

    /**
      * This method adds a widget to the list of mandatory fields for the current dialog
      *
      * @param widget pointer to the widget to be added
      */
    void add(QWidget *widget);

    /**
      * This method removes a widget form the list of mandatory fields for the current dialog
      *
      * @param widget pointer to the widget to be removed
      */
    void remove(QWidget *widget);

    /**
     * This method removes all widgets from the list of mandatory fields for the current dialog
     */
    void removeAll();

    /**
      * This method designates the button to be enabled when all mandatory fields
      * have been completed
      *
      * @param button pointer to the 'ok' button
      */
    void setOkButton(QPushButton *button);

    /**
      * This method returns if all requirements for the mandatory group
      * have been fulfilled (@p true) or not (@p false).
      */
    bool isEnabled() const;

public Q_SLOTS:
    void clear();

    /**
      * Force update of ok button
      */
    void changed();

    /**
     * Use this slot to set the initial @a state when checking
     * for all mandatory data. This can be used to add support
     * for widgets that are not directly supported by
     * this object. The default @a state when this method
     * was never called is @c true.
     */
    void setExternalMandatoryState(bool state);

Q_SIGNALS:
    void stateChanged();
    void stateChanged(bool state);

private:
    KMandatoryFieldGroupPrivate * const d_ptr;
    Q_DECLARE_PRIVATE(KMandatoryFieldGroup)
};

#endif // KGUIUTILS_H
