Diffstat (limited to 'kaddressbook/viewconfigurewidget.h') (more/less context) (ignore whitespace changes)
| -rw-r--r-- | kaddressbook/viewconfigurewidget.h | 106 |
1 files changed, 106 insertions, 0 deletions
diff --git a/kaddressbook/viewconfigurewidget.h b/kaddressbook/viewconfigurewidget.h new file mode 100644 index 0000000..0c2b77c --- a/dev/null +++ b/kaddressbook/viewconfigurewidget.h @@ -0,0 +1,106 @@ +/* + This file is part of KAddressBook. + Copyright (c) 2002 Mike Pilone <mpilone@slac.com> + + This program is free software; you can rremovePageedistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + + As a special exception, permission is given to link this program + with any edition of Qt, and distribute the resulting executable, + without including the source code for Qt in the source distribution. +*/ + +#ifndef VIEWCONFIGUREWIDGET_H +#define VIEWCONFIGUREWIDGET_H + + + +#include "configurewidget.h" + +class QVBox; + +#include <kdialogbase.h> +#include <qpixmap.h> + +class KJanusWidget; +class QString; +class ViewConfigureFieldsPage; +class ViewConfigureFilterPage; +class ViewConfigureDialog; +/** + This widget is the base class for all view configuration widgets. The + author of a view may wish to inherit from this widget and add config pages + that add custom config options. The default implementation of this widget + is to show a page with the select fields widget. For simple views this may + be sufficient. +*/ +class ViewConfigureWidget : public ConfigureWidget +{ + Q_OBJECT + + public: + ViewConfigureWidget( KABC::AddressBook *ab, QWidget *parent, const char *name = 0 ); + virtual ~ViewConfigureWidget(); + + /** + Reads the configuration from the config object and sets the values + in the GUI. If this method is overloaded, be sure to call the base + class's method. + + Do not change the group of the config object in this method. + */ + virtual void restoreSettings( KConfig *config ); + + /** + Writes the configuration from the GUI to the config object. If this + method is overloaded, be sure to call the base class's method. + + Do not change the group of the config object in this method. + */ + virtual void saveSettings( KConfig *config ); + + + /** + Use this method to add new pages to the widget. + */ + QVBox *addPage( const QString &item, const QString &header = QString::null, + const QPixmap &pixmap = QPixmap() ); + + private: + KJanusWidget *mMainWidget; + + ViewConfigureFieldsPage *mFieldsPage; + ViewConfigureFilterPage *mFilterPage; +}; + +class ViewConfigureDialog : public KDialogBase +{ + Q_OBJECT + + public: + ViewConfigureDialog( ViewConfigureWidget *wdg, const QString &viewName, + QWidget *parent, const char *name = 0 ); + ~ViewConfigureDialog(); + + void restoreSettings( KConfig* ); + void saveSettings( KConfig* ); + void setWidget( ViewConfigureWidget *wdg ); + protected slots: + void slotHelp(); + + private: + ViewConfigureWidget *mConfigWidget; +}; + +#endif |