addresseeview.h

/*
    This file is part of libtdepim.
 
    Copyright (c) 2003 Tobias Koenig <tokoe@kde.org>
 
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.
 
    This library 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
    Library General Public License for more details.
 
    You should have received a copy of the GNU Library General Public License
    along with this library; see the file COPYING.LIB.  If not, write to
    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
    Boston, MA 02110-1301, USA.
*/
 
#ifndef KPIM_ADDRESSEEVIEW_H
#define KPIM_ADDRESSEEVIEW_H
 
#include <tqcstring.h>
 
#include <tdeabc/addressee.h>
#include <ktextbrowser.h>
#include <tdeimproxy.h>
#include <tdemacros.h>
 
namespace TDEIO {
class Job;
}
class TDEToggleAction;
 
class TQPopupMenu;
 
 
namespace KPIM {
 
 
class TDE_EXPORT AddresseeView : public KTextBrowser
{
  TQ_OBJECT
  
  public:
    AddresseeView( TQWidget *parent = 0, const char *name = 0,
                   TDEConfig *config = 0 );
 
    ~AddresseeView();
 
    void setAddressee( const TDEABC::Addressee& addr );
 
    TDEABC::Addressee addressee() const;
 
 
    enum LinkMask {
      NoLinks = 0,
      AddressLinks = 1,
      EmailLinks = 2,
      PhoneLinks = 4,
      URLLinks = 8,
      IMLinks = 16,
      DefaultLinks = AddressLinks | EmailLinks | PhoneLinks | URLLinks | IMLinks
    };
 
    void enableLinks( int linkMask );
 
    enum FieldMask {
      NoFields = 0,
      BirthdayFields = 1,
      AddressFields = 2,
      EmailFields = 4,
      PhoneFields = 8,
      URLFields = 16,
      IMFields = 32,
      CustomFields = 64,
      DefaultFields = AddressFields | EmailFields | PhoneFields | URLFields
    };
 
    static TQString vCardAsHTML( const TDEABC::Addressee& addr, ::KIMProxy *proxy, LinkMask linkMask = DefaultLinks,
                                bool internalLoading = true, FieldMask fieldMask = DefaultFields );
 
    static TQString pixmapAsDataUrl( const TQPixmap& pixmap );
 
  signals:
    void urlHighlighted( const TQString &url );
    void emailHighlighted( const TQString &email );
    void phoneNumberHighlighted( const TQString &number );
    void faxNumberHighlighted( const TQString &number );
 
    void highlightedMessage( const TQString &message );
 
    void addressClicked( const TQString &uid );
 
  protected:
    virtual void urlClicked( const TQString &url );
    virtual void emailClicked( const TQString &mail );
    virtual void phoneNumberClicked( const TQString &number );
    virtual void smsTextClicked( const TQString &number );
    virtual void sendSMS( const TQString &number, const TQString &msg );
    virtual void faxNumberClicked( const TQString &number );
    virtual void imAddressClicked();
 
    virtual TQPopupMenu *createPopupMenu( const TQPoint& );
 
  private slots:
    void slotMailClicked( const TQString&, const TQString& );
    void slotUrlClicked( const TQString& );
    void slotHighlighted( const TQString& );
    void slotPresenceChanged( const TQString & );
    void slotPresenceInfoExpired();
    void configChanged();
 
    void data( TDEIO::Job*, const TQByteArray& );
    void result( TDEIO::Job* );
 
  private:
    void load();
    void save();
 
    void updateView();
 
    TQString strippedNumber( const TQString &number );
 
    TDEConfig *mConfig;
    bool mDefaultConfig;
 
    TQByteArray mImageData;
    TDEIO::Job *mImageJob;
 
    TDEToggleAction *mActionShowBirthday;
    TDEToggleAction *mActionShowAddresses;
    TDEToggleAction *mActionShowEmails;
    TDEToggleAction *mActionShowPhones;
    TDEToggleAction *mActionShowURLs;
    TDEToggleAction *mActionShowIMAddresses;
    TDEToggleAction *mActionShowCustomFields;
 
    TDEABC::Addressee mAddressee;
    int mLinkMask;
 
    class AddresseeViewPrivate;
    AddresseeViewPrivate *d;
    ::KIMProxy *mKIMProxy;
};
 
}
 
#endif