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 <ntqlistview.h>
#include <ntqvbox.h>
#include <kdialogbase.h>


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


class KFeedbackForm;
class KFeedbackQuestionList;
class KFeedbackQuestion;
class KFeedbackAnswer;
class TQMultiLineEdit;


class KFeedbackDialog: public KDialogBase
{
    Q_OBJECT

public:

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


    virtual ~KFeedbackDialog();


    KFeedbackForm *form() { return _form; }


public slots:

    void checkSendButton();


signals:
    void mailSent();


protected:

    KFeedbackForm *  _form;
};


class KFeedbackForm: public TQVBox
{
    Q_OBJECT

public:
    KFeedbackForm( const TQString & feedbackMailAddress,
                 TQWidget *         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:

    TQString formatComment();


    TQString                 _feedbackMailAddress;
    KFeedbackQuestionList * _questionList;
    TQMultiLineEdit *        _comment;
};



class KFeedbackQuestionList: public TQListView
{
    Q_OBJECT

public:

    KFeedbackQuestionList( TQWidget *parent );

    virtual ~KFeedbackQuestionList();

    virtual bool isComplete();

    TQString result();

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

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

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

    void questionAnswered();

    void questionAdded( KFeedbackQuestion * question );

signals:
    void checkComplete();
};


class KFeedbackQuestion: public TQCheckListItem
{
public:

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

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

    bool isRequired() { return _required; }

    bool isAnswered();

    TQString result();

    TQString id() { return _id; }

    TQString text();

    bool exclusiveAnswer() { return _exclusiveAnswer; }


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

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

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

    KFeedbackQuestionList * questionList() const;


protected:

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


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

    TQString id() { return _id; }

    TQString text();

    bool isExclusive() { return _exclusive; }

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

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

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

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


    virtual void stateChange( bool newState );

protected:

    TQString   _id;
    bool      _exclusive;
    int              _no;
};



#endif // KFeedback_h


// EOF

---