File indexing completed on 2024-05-12 05:07:55

 /*
     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_base_widgets_export.h"
 
 class QWidget;
 class QPushButton;
 
 /**
   * @author Tony Bloomfield
   */
 class KMandatoryFieldGroupPrivate;
 class KMM_BASE_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