source: psi/trunk/src/options/optionstab.h@ 76

#ifndef OPTIONSTAB_H
#define OPTIONSTAB_H

#include <qcstring.h>
#include <qstring.h>
#include <qobject.h>
#include <qptrlist.h>

struct Options;
class Icon;
class QWidget;
class PsiCon;

class OptionsTab : public QObject
{
        Q_OBJECT
public:
        OptionsTab(QObject *parent, const char *name = 0);
        OptionsTab(QObject *parent, QCString id, QCString parentId, QString name, QString desc, QString tabIconName = QString::null, QString iconName = QString::null);
        ~OptionsTab();

        virtual QCString id() const;            // Unique identifier, i.e. "plugins_misha's_cool-plugin"
        virtual QCString parentId() const;      // Identifier of parent tab, i.e. "general"

        virtual QString tabName() const;        // "General"
        virtual Icon *tabIcon() const;          // default implementation returns 0

        virtual QString name() const;           // "Roster"
        virtual QString desc() const;           // "You can configure your roster here"
        virtual Icon *icon() const;             // default implementation returns 0

        virtual QWidget *widget() = 0;          // Actual widget that contains checkboxes, pushbuttons, etc.
                                                // the widget is reparented after this call
        virtual bool stretchable() const;       // return 'true' if widget() is stretchable and wants a lot of space

signals:
        void dataChanged();
        //void addWidgetChangedSignal(QString widgetName, QCString signal);
        void noDirty(bool);
        void connectDataChanged(QWidget *);

public slots:
        virtual void setData(PsiCon *, QWidget *parentDialog);
        virtual void applyOptions(Options *opt);
        virtual void restoreOptions(const Options *opt);
        virtual void tabAdded(OptionsTab *tab); // called when tab 'tab' specifies this tab as parent

private:
        QCString v_id, v_parentId;
        QString v_name, v_desc, v_tabIconName, v_iconName;
};

class MetaOptionsTab : public OptionsTab
{
        Q_OBJECT
public:
        MetaOptionsTab(QObject *parent, const char *name = 0);
        MetaOptionsTab(QObject *parent, QCString id, QCString parentId, QString name, QString desc, QString tabIconName = QString::null, QString iconName = QString::null);
        ~MetaOptionsTab();

        QWidget *widget();
        void applyOptions(Options *opt);
        void restoreOptions(const Options *opt);

        void setData(PsiCon *, QWidget *);
        bool stretchable() const { return true; }

        void addTab(OptionsTab *);

private:
        void init();
        QWidget *w;
        QPtrList<OptionsTab> tabs;
};

#endif