author | zautrix <zautrix> | 2004-06-26 19:01:18 (UTC) |
---|---|---|
committer | zautrix <zautrix> | 2004-06-26 19:01:18 (UTC) |
commit | b9aad1f15dc600e4dbe4c62d3fcced6363188ba3 (patch) (side-by-side diff) | |
tree | 2c3d4004fb21c72cba65793859f9bcd8ffd3a49c /kaddressbook/details/look_basic.h | |
download | kdepimpi-b9aad1f15dc600e4dbe4c62d3fcced6363188ba3.zip kdepimpi-b9aad1f15dc600e4dbe4c62d3fcced6363188ba3.tar.gz kdepimpi-b9aad1f15dc600e4dbe4c62d3fcced6363188ba3.tar.bz2 |
Initial revision
Diffstat (limited to 'kaddressbook/details/look_basic.h') (more/less context) (show whitespace changes)
-rw-r--r-- | kaddressbook/details/look_basic.h | 134 |
1 files changed, 134 insertions, 0 deletions
diff --git a/kaddressbook/details/look_basic.h b/kaddressbook/details/look_basic.h new file mode 100644 index 0000000..7e8baff --- a/dev/null +++ b/kaddressbook/details/look_basic.h @@ -0,0 +1,134 @@ +/* + This file is part of KAddressBook. + Copyright (c) 1996-2002 Mirko Boehm <mirko@kde.org> + + This program is free software; you can redistribute 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 LOOK_KABBASIC_H +#define LOOK_KABBASIC_H + +#include <kabc/addressbook.h> +#include <qvbox.h> + +class KConfig; + +/** + This is a pure virtual base class that defines the + interface for how to display and change entries of + the KDE addressbook. + + This basic widget does not show anything in its client space. + Derive it and implement its look and how the user may edit the + entry. + + The paintEvent() has to paint the whole widget, since repaint() + calls will not delete the widgets background. + */ +class KABBasicLook : public QVBox +{ + Q_OBJECT + + public: + /** + The constructor. + */ + KABBasicLook( QWidget *parent = 0, const char *name = 0 ); + + /** + Set the entry. It will be displayed automatically. + */ + virtual void setAddressee( const KABC::Addressee& addressee ); + + /** + Get the current entry. + */ + virtual KABC::Addressee addressee(); + + /** + Configure the view from the configuration file. + */ + virtual void restoreSettings( KConfig* ); + + /** + Save the view settings to the configuration file. + */ + virtual void saveSettings( KConfig* ); + + /** + Retrieve read-write state. + */ + bool isReadOnly() const; + + signals: + /** + This signal is emitted when the user changed the entry. + */ + void entryChanged(); + + /** + This signal indicates that the entry needs to be changed + immidiately in the database. This might be due to changes in + values that are available in menus. + */ + void saveMe(); + + /** + The user acticated the email address displayed. This may happen + by, for example, clicking on the displayed mailto-URL. + */ + void sendEmail( const QString &email ); + + /** + The user activated one of the displayed HTTP URLs. For example + by clicking on the displayed homepage address. + */ + void browse( const QString &url ); + + public slots: + /** + Set read-write state. + */ + virtual void setReadOnly( bool state ); + + private: + KABC::Addressee mAddressee; + bool mReadOnly; +}; + +class KABLookFactory +{ + public: + KABLookFactory( QWidget *parent = 0, const char *name = 0 ); + virtual ~KABLookFactory(); + + virtual KABBasicLook *create() = 0; + + /** + Overload this method to provide a one-liner description + for your look. + */ + virtual QString description() = 0; + + protected: + QWidget *mParent; + const char* mName; +}; + +#endif |