kfeedback.h

/*
 *   File name:      kfeedback.h
 *   Summary: User feedback form and mailing utilities
 *   License: LGPL - See file COPYING.LIB for details.
 *   Author:  Stefan Hundhammer <sh@suse.de>
 *
 *   Updated: 2002-02-24
 *
 *   $Id: kfeedback_8h-source.html,v 1.10 2007/07/05 17:37:51 kuddel-fl Exp $
 *
 */


#ifndef KFeedback_h
#define KFeedback_h

#ifdef HAVE_CONFIG_H
#include <config.h>
#endif

#include <qlistview.h>
#include <qvbox.h>
#include <kdialogbase.h>


#ifndef NOT_USED
#    define NOT_USED(PARAM) ( (void) (PARAM) )
#endif


class KFeedbackForm;
class KFeedbackQuestionList;
class KFeedbackQuestion;
class KFeedbackAnswer;
class QMultiLineEdit;


class KFeedbackDialog: public KDialogBase
{
    Q_OBJECT

public:

    KFeedbackDialog( const QString & feedbackMailAddress,
                   const QString & helpTopic = QString::null );


    virtual ~KFeedbackDialog();


    KFeedbackForm *form() { return _form; }


public slots:

    void checkSendButton();


signals:
    void mailSent();


protected:

    KFeedbackForm *  _form;
};


class KFeedbackForm: public QVBox
{
    Q_OBJECT

public:
    KFeedbackForm( const QString & feedbackMailAddress,
                 QWidget *         parent );

    virtual ~KFeedbackForm();


public slots:

     virtual void sendMail();


public:

    virtual bool readyToSend();

    KFeedbackQuestionList * questionList() { return _questionList; }


signals:
    void mailSent();

    void checkComplete();


protected slots:
    void slotCheckComplete();


protected:

    QString formatComment();


    QString                 _feedbackMailAddress;
    KFeedbackQuestionList * _questionList;
    QMultiLineEdit *        _comment;
};



class KFeedbackQuestionList: public QListView
{
    Q_OBJECT

public:

    KFeedbackQuestionList( QWidget *parent );

    virtual ~KFeedbackQuestionList();

    virtual bool isComplete();

    QString result();

    KFeedbackQuestion * addQuestion( const QString &    text,
                                 const QString & id,
                                 bool            exclusiveAnswer      = true,
                                 bool            required      = false );

    void addYesNoQuestion( const QString &       text,
                        const QString &   id,
                        bool              required = false );

    KFeedbackQuestion * firstQuestion() const
       { return (KFeedbackQuestion *) QListView::firstChild(); }

    void questionAnswered();

    void questionAdded( KFeedbackQuestion * question );

signals:
    void checkComplete();
};


class KFeedbackQuestion: public QCheckListItem
{
public:

    KFeedbackQuestion( KFeedbackQuestionList *   parent,
                     const QString &             text,
                     const QString &             id,
                     bool                 exclusiveAnswer      = true,
                     bool                 required      = false,
                     bool                 open          = true );

    void addAnswer( const QString & text,
                  const QString & id   );

    bool isRequired() { return _required; }

    bool isAnswered();

    QString result();

    QString id() { return _id; }

    QString text();

    bool exclusiveAnswer() { return _exclusiveAnswer; }


    virtual QString key( int column, bool ascending ) const;

    KFeedbackQuestion * nextQuestion() const
       { return (KFeedbackQuestion *) QListViewItem::nextSibling(); }

    KFeedbackAnswer * firstAnswer() const
       { return (KFeedbackAnswer *) QListViewItem::firstChild(); }

    KFeedbackQuestionList * questionList() const;


protected:

    QString   _id;
    bool      _exclusiveAnswer;
    bool      _required;
    int              _no;
};


class KFeedbackAnswer: public QCheckListItem
{
public:
    KFeedbackAnswer( KFeedbackQuestion *  parent,
                   const QString &        text,
                   const QString &        id,
                   bool                   exclusive = true );

    QString id() { return _id; }

    QString text();

    bool isExclusive() { return _exclusive; }

    bool isChecked() { return QCheckListItem::isOn(); }

    KFeedbackAnswer * nextAnswer() const
       { return (KFeedbackAnswer *) QListViewItem::nextSibling(); }

    KFeedbackQuestion * question() const
       { return (KFeedbackQuestion *) QListViewItem::parent(); }

    virtual QString key( int column, bool ascending ) const;


    virtual void stateChange( bool newState );

protected:

    QString   _id;
    bool      _exclusive;
    int              _no;
};



#endif // KFeedback_h


// EOF

---