imeditorwidget.h

/*
  IM addresses editor widget for KAddressbook
 
  Copyright (c) 2004 Will Stephenson   <lists@stevello.free-online.co.uk>
 
    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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 
    As a special exception, permission is given to link this program
    with any edition of TQt, and distribute the resulting executable,
    without including the source code for TQt in the source distribution.
*/
 
#ifndef IMEDITORWIDGET_H
#define IMEDITORWIDGET_H
 
#include <tqvaluelist.h>
#include <tdelistview.h>
#include <kdialogbase.h>
 
#include "contacteditorwidget.h"
 
 
class AddressWidget;
class KPluginInfo;
class IMEditorBase;
 
enum IMContext { Any, Home, Work };
 
/* Note regarding Context:
 * It wasn not possible to get an idea of Context into Kopete in time for KDE 3.3,
 * so it has been removed from the UI and functionally disabled in the code.
 */
 
class IMEditorWidget : public KDialogBase
{
  TQ_OBJECT
  
 
  public:
    IMEditorWidget( TQWidget *parent, const TQString &preferredIM, const char *name = 0 );
    ~IMEditorWidget() {};
 
    void loadContact( TDEABC::Addressee *addr );
    void storeContact( TDEABC::Addressee *addr );
    void setReadOnly( bool readOnly );
    TQValueList<KPluginInfo *> availableProtocols() const;
    bool isModified() const;
    TQString preferred() const;
 
  protected slots:
    void slotUpdateButtons();
    void slotAdd();
    void slotEdit();
    void slotDelete();
    void slotSetStandard();
 
  protected:
    static void splitField( const TQString &str, TQString &app, TQString &name, TQString &value );
 
    KPluginInfo * protocolFromString( const TQString &fieldValue ) const;
 
  private:
    bool mReadOnly;
    bool mModified;
    TQString mPreferred;
    IMEditorBase *mWidget;
    void setModified( bool modified );
 
    // Used to track changed protocols to reduce KABC writes
    TQValueList<KPluginInfo *> mChangedProtocols;
    TQValueList<KPluginInfo *> mProtocols;
};
 
// VCard has been disabled as there is no standard VCard location to store IM addresses yet.
class IMAddressLVI : public TDEListViewItem
{
  public:
    IMAddressLVI( TDEListView *parent, KPluginInfo * protocol,
                  const TQString &address, const IMContext &context = Any );
 
    void setAddress( const TQString &address );
    void setProtocol( KPluginInfo * protocol );
    void setContext( const IMContext &context );
    void activate();
 
    KPluginInfo * protocol() const;
    TQString address() const;
    IMContext context() const;
 
    void setPreferred( bool preferred );
    bool preferred() const;
 
  protected:
    virtual void paintCell( TQPainter *p, const TQColorGroup &cg, int column, int width, int alignment );
 
  private:
    KPluginInfo * mProtocol;
    bool mPreferred;
    IMContext mContext;
    TQString mAddress;
};
 
#endif