kmreaderwin.h

// -*- mode: C++; c-file-style: "gnu" -*-
// Header for kmreaderwin the kmail reader
// written by Markus Wuebben <markus.wuebben@kde.org>
 
#ifndef KMREADERWIN_H
#define KMREADERWIN_H
 
#include <tqwidget.h>
#include <tqtimer.h>
#include <tqstringlist.h>
#include <kurl.h>
#include <kservice.h>
#include "kmmsgbase.h"
#include "kmmimeparttree.h" // Needed for friend declaration.
#include "interfaces/observer.h"
 
#include <map>
 
class TQFrame;
class TQSplitter;
class TQHBox;
class TQListViewItem;
class TQScrollBar;
class TQString;
class TQTabDialog;
class TQTextCodec;
 
class DwHeaders;
class DwMediaType;
 
class TDEActionCollection;
class TDEAction;
class TDEActionMenu;
class TDESelectAction;
class TDERadioAction;
class TDEToggleAction;
class TDEConfigBase;
class TDEHTMLPart;
class KURL;
 
class KMFolder;
class KMMessage;
class KMMessagePart;
namespace KMail {
  namespace Interface {
    class Observable;
    class BodyPartMemento;
  }
  class PartMetaData;
  class ObjectTreeParser;
  class AttachmentStrategy;
  class HeaderStrategy;
  class HeaderStyle;
  class HtmlWriter;
  class KHtmlPartHtmlWriter;
  class ISubject;
  class HtmlStatusBar;
  class FolderJob;
  class CSSHelper;
}
 
class partNode; // might be removed when KMime is used instead of mimelib
                //                                      (khz, 29.11.2001)
 
class NewByteArray; // providing operator+ on a TQByteArray (khz, 21.06.2002)
 
namespace KParts {
  struct URLArgs;
}
 
class KMReaderWin: public TQWidget, public KMail::Interface::Observer {
  Q_OBJECT
  
 
  friend void KMMimePartTree::itemClicked( TQListViewItem* item );
  friend void KMMimePartTree::itemRightClicked( TQListViewItem* item, const TQPoint & );
  friend void KMMimePartTree::slotSaveAs();
  friend void KMMimePartTree::startDrag();
 
  friend class KMail::ObjectTreeParser;
  friend class KMail::KHtmlPartHtmlWriter;
 
public:
  KMReaderWin( TQWidget *parent,
           TQWidget *mainWindow,
           TDEActionCollection *actionCollection,
               const char *name=0,
           int f=0 );
  virtual ~KMReaderWin();
 
  void update( KMail::Interface::Observable * );
 
  void readConfig();
 
  void writeConfig( bool withSync=true ) const;
 
  const KMail::HeaderStyle * headerStyle() const {
    return mHeaderStyle;
  }
  void setHeaderStyleAndStrategy( const KMail::HeaderStyle * style,
                  const KMail::HeaderStrategy * strategy );
 
  const KMail::HeaderStrategy * headerStrategy() const {
    return mHeaderStrategy;
  }
 
  const KMail::AttachmentStrategy * attachmentStrategy() const {
    return mAttachmentStrategy;
  }
  void setAttachmentStrategy( const KMail::AttachmentStrategy * strategy );
 
  TQString overrideEncoding() const { return mOverrideEncoding; }
 
  void setOverrideEncoding( const TQString & encoding );
 
  void setPrintFont( const TQFont& font );
 
  const TQTextCodec * overrideCodec() const;
 
  virtual void setPrinting(bool enable) { mPrinting = enable; }
 
  virtual void setMsg( KMMessage* msg, bool force = false, bool updateOnly = false );
 
  void setOriginalMsg( unsigned long serNumOfOriginalMessage, int nodeIdOffset );
 
  void setMsgPart( KMMessagePart* aMsgPart, bool aHTML,
           const TQString& aFileName, const TQString& pname );
 
  void setMsgPart( partNode * node );
 
  void showHideMimeTree( bool isPlainTextTopLevel );
 
  void setIdOfLastViewedMessage( const TQString & msgId )
    { mIdOfLastViewedMessage = msgId; }
 
  void clear(bool force = false) { setMsg(0, force); }
 
  void saveRelativePosition();
 
  void update(bool force = false);
 
  virtual void printMsg(void);
 
  TQString copyText();
 
  bool autoDelete(void) const { return mAutoDelete; }
  void setAutoDelete(bool f) { mAutoDelete=f; }
 
  bool htmlOverride() const { return mHtmlOverride; }
  void setHtmlOverride( bool override );
 
  bool htmlLoadExtOverride() const { return mHtmlLoadExtOverride; }
  void setHtmlLoadExtOverride( bool override );
 
  bool htmlMail();
 
  bool htmlLoadExternal();
 
  static TQString newFeaturesMD5();
 
  void displaySplashPage( const TQString &info );
 
  void displayAboutPage();
 
  void displayBusyPage();
  void displayOfflinePage();
 
  void enableMsgDisplay();
 
  void atmViewMsg( KMMessagePart* msgPart, int nodeId );
 
  bool atBottom() const;
 
  bool isFixedFont() { return mUseFixedFont; }
  void setUseFixedFont( bool useFixedFont ) { mUseFixedFont = useFixedFont; }
 
  KMail::HtmlWriter * htmlWriter() { return mHtmlWriter; }
 
  // Action to reply to a message
  // but action( "some_name" ) some name could be used instead.
  TDEToggleAction *toggleFixFontAction() { return mToggleFixFontAction; }
  TDEToggleAction *toggleMimePartTreeAction() { return mToggleMimePartTreeAction; }
  TDEAction *mailToComposeAction() { return mMailToComposeAction; }
  TDEAction *mailToReplyAction() { return mMailToReplyAction; }
  TDEAction *mailToForwardAction() { return mMailToForwardAction; }
  TDEAction *addAddrBookAction() { return mAddAddrBookAction; }
  TDEAction *openAddrBookAction() { return mOpenAddrBookAction; }
  TDEAction *copyAction() { return mCopyAction; }
  TDEAction *selectAllAction() { return mSelectAllAction; }
  TDEAction *copyURLAction() { return mCopyURLAction; }
  TDEAction *urlOpenAction() { return mUrlOpenAction; }
  TDEAction *urlSaveAsAction() { return mUrlSaveAsAction; }
  TDEAction *addBookmarksAction() { return mAddBookmarksAction;}
  TDEAction *startImChatAction() { return mStartIMChatAction; }
  // This function returns the complete data that were in this
  // message parts - *after* all encryption has been removed that
  // could be removed.
  // - This is used to store the message in decrypted form.
  void objectTreeToDecryptedMsg( partNode* node,
                                 NewByteArray& resultingData,
                                 KMMessage& theMessage,
                                 bool weAreReplacingTheRootNode = false,
                                 int recCount = 0 );
 
  partNode* partNodeFromUrl(const KURL &url);
 
  partNode * partNodeForId( int id );
 
  KURL tempFileUrlFromPartNode( const partNode * node );
 
  static int msgPartFromUrl(const KURL &url);
 
  void setUpdateAttachment( bool update = true ) { mAtmUpdate = update; }
 
  TDEHTMLPart * htmlPart() const { return mViewer; }
 
  KMMessage* message(KMFolder** folder=0) const;
 
  void openAttachment( int id, const TQString & name );
  void saveAttachment( const KURL &tempFileName );
 
  void emitUrlClicked( const KURL & url, int button ) {
    emit urlClicked( url, button );
  }
 
  void emitPopupMenu( const KURL & url, const TQPoint & p ) {
    if ( message() )
      emit popupMenu( *message(), url, p );
  }
 
  void showAttachmentPopup( int id, const TQString & name, const TQPoint & p );
 
  void setWaitingForSerNum( unsigned long serNum ) { mWaitingForSerNum = serNum; }
 
  TQWidget* mainWindow() { return mMainWindow; }
 
  bool decryptMessage() const;
 
  void setDecryptMessageOverwrite( bool overwrite = true ) { mDecrytMessageOverwrite = overwrite; }
 
  bool showSignatureDetails() const { return mShowSignatureDetails; }
 
  void setShowSignatureDetails( bool showDetails = true ) { mShowSignatureDetails = showDetails; }
 
  /* show or hide the list that points to the attachments */
  bool showAttachmentQuicklist() const { return mShowAttachmentQuicklist; }
 
  /* show or hide the list that points to the attachments */
  void setShowAttachmentQuicklist( bool showAttachmentQuicklist = true ) { mShowAttachmentQuicklist = showAttachmentQuicklist; }
 
  // This controls whether a Toltec invitation is shown in its raw form or as a replacement text.
  // This can be toggled with the "kmail:showRawToltecMail" link.
  bool showRawToltecMail() const { return mShowRawToltecMail; }
  void setShowRawToltecMail( bool showRawToltecMail ) { mShowRawToltecMail = showRawToltecMail; }
 
  /* retrieve BodyPartMemento of id \a which for partNode \a node */
  KMail::Interface::BodyPartMemento * bodyPartMemento( const partNode * node, const TQCString & which ) const;
 
  /* set/replace BodyPartMemento \a memento of id \a which for
     partNode \a node. If there was a BodyPartMemento registered
     already, replaces (deletes) that one. */
  void setBodyPartMemento( const partNode * node, const TQCString & which, KMail::Interface::BodyPartMemento * memento );
 
  void scrollToAttachment( const partNode *node );
 
private:
  /* deletes all BodyPartMementos. Use this when skipping to another
     message (as opposed to re-loading the same one again). */
  void clearBodyPartMementos();
 
signals:
  void replaceMsgByUnencryptedVersion();
 
  void popupMenu(KMMessage &msg, const KURL &url, const TQPoint& mousePos);
 
  void urlClicked(const KURL &url, int button);
 
  void noDrag(void);
 
public slots:
 
  void selectAll();
 
  void clearCache();
 
  void updateReaderWin();
 
  void slotScrollUp();
  void slotScrollDown();
  void slotScrollPrior();
  void slotScrollNext();
  void slotJumpDown();
  void slotDocumentChanged();
  void slotDocumentDone();
  void slotTextSelected(bool);
  void updateHeader();
 
  void slotUrlOpen(const KURL &url, const KParts::URLArgs &args);
 
  void slotUrlOn(const TQString &url);
 
  void slotUrlPopup(const TQString &, const TQPoint& mousePos);
 
  void slotFind();
  void slotFindNext();
 
  void slotToggleFixedFont();
 
  void slotToggleMimePartTree();
 
  void slotCopySelectedText();
 
  void slotUrlClicked();
 
  void slotMailtoReply();
  void slotMailtoCompose();
  void slotMailtoForward();
  void slotMailtoAddAddrBook();
  void slotMailtoOpenAddrBook();
  void slotUrlCopy();
  void slotUrlOpen( const KURL &url = KURL() );
  void slotUrlSave();
  void slotAddBookmarks();
  void slotSaveMsg();
  void slotSaveAttachments();
 
  void slotMessageArrived( KMMessage *msg );
  void slotIMChat();
  void contactStatusChanged( const TQString &uid);
 
  void slotLevelQuote( int l );
  void slotTouchMessage();
 
  void fillCommandInfo( partNode *node, KMMessage **msg, int *nodeId );
 
  void slotDeleteAttachment( partNode* node );
  void slotEditAttachment( partNode* node );
 
  KMail::CSSHelper* cssHelper();
 
protected slots:
  void slotCycleHeaderStyles();
  void slotBriefHeaders();
  void slotFancyHeaders();
  void slotEnterpriseHeaders();
  void slotStandardHeaders();
  void slotLongHeaders();
  void slotAllHeaders();
 
  void slotCycleAttachmentStrategy();
  void slotIconicAttachments();
  void slotSmartAttachments();
  void slotInlineAttachments();
  void slotHideAttachments();
  void slotHeaderOnlyAttachments();
 
  void slotAtmView( int id, const TQString& name );
  void slotDelayedResize();
  void slotHandleAttachment( int );
 
  void disconnectMsgAdded();
  void msgAdded( TQListViewItem *item );
 
protected:
  void styleChange( TQStyle& oldStyle );
 
  void setStyleDependantFrameWidth();
 
  virtual bool event(TQEvent *e);
 
  int pointsToPixel(int pointSize) const;
 
  void displayMessage();
 
  virtual void parseMsg( KMMessage* msg  );
 
  TQString writeMsgHeader(KMMessage* aMsg, partNode *vCardNode = 0, bool topLevel=false );
 
  TQString writeMessagePartToTempFile( KMMessagePart* msgPart, int partNumber );
 
  TQString createTempDir( const TQString &param = TQString() );
 
  void showVCard(KMMessagePart *msgPart);
 
  virtual void initHtmlWidget(void);
 
  virtual void closeEvent(TQCloseEvent *);
  virtual void resizeEvent(TQResizeEvent *);
 
  virtual void removeTempFiles();
 
  bool eventFilter( TQObject *obj, TQEvent *ev );
 
private slots:
  void slotSetEncoding();
  void injectAttachments();
 
private:
  void adjustLayout();
  void createWidgets();
  void createActions( TDEActionCollection * ac );
  void saveSplitterSizes( TDEConfigBase & c ) const;
 
  TDERadioAction * actionForHeaderStyle( const KMail::HeaderStyle *,
                                       const KMail::HeaderStrategy * );
  TDERadioAction * actionForAttachmentStrategy( const KMail::AttachmentStrategy * );
  void readGlobalOverrideCodec();
 
  TQString renderAttachments( partNode *node, const TQColor &bgColor );
 
private:
  bool mHtmlMail, mHtmlLoadExternal, mHtmlOverride, mHtmlLoadExtOverride;
  int mAtmCurrent;
  TQString mAtmCurrentName;
  KMMessage *mMessage;
 
  // See setOriginalMsg() for an explaination for those two.
  unsigned long mSerNumOfOriginalMessage;
  int mNodeIdOffset;
 
  // widgets:
  TQSplitter * mSplitter;
  TQHBox *mBox;
  KMail::HtmlStatusBar *mColorBar;
  KMMimePartTree* mMimePartTree;
  TDEHTMLPart *mViewer;
 
  const KMail::AttachmentStrategy * mAttachmentStrategy;
  const KMail::HeaderStrategy * mHeaderStrategy;
  const KMail::HeaderStyle * mHeaderStyle;
  bool mAutoDelete;
  TQString mSaveAttachDir;
  static const int delay;
  TQTimer mUpdateReaderWinTimer;
  TQTimer mResizeTimer;
  TQTimer mDelayedMarkTimer;
  TQTimer mHeaderRefreshTimer;
  TQString mOverrideEncoding;
  TQString mOldGlobalOverrideEncoding; // used to detect changes of the global override character encoding
  bool mMsgDisplay;
  bool mNoMDNsWhenEncrypted;
  unsigned long mLastSerNum;
 
  KMail::CSSHelper * mCSSHelper;
  bool mUseFixedFont;
  bool mPrinting;
  bool mShowColorbar;
  //bool mShowCompleteMessage;
  TQStringList mTempFiles;
  TQStringList mTempDirs;
  int mMimeTreeMode;
  int mMimeTreeModeOverride;
  bool mMimeTreeAtBottom;
  TQValueList<int> mSplitterSizes;
  partNode* mRootNode;
  TQString mIdOfLastViewedMessage;
  TQWidget *mMainWindow;
  TDEActionCollection *mActionCollection;
  TDEAction *mMailToComposeAction, *mMailToReplyAction, *mMailToForwardAction,
      *mAddAddrBookAction, *mOpenAddrBookAction, *mCopyAction, *mCopyURLAction,
      *mUrlOpenAction, *mUrlSaveAsAction, *mAddBookmarksAction, *mStartIMChatAction, *mSelectAllAction;
  TDEToggleAction *mHeaderOnlyAttachmentsAction;
  TDESelectAction *mSelectEncodingAction;
  TDEToggleAction *mToggleFixFontAction;
  TDEToggleAction *mToggleMimePartTreeAction;
 
  KURL mHoveredUrl;
  KURL mClickedUrl;
  TQPoint mLastClickPosition;
  TQString mLastClickImagePath;
  bool mCanStartDrag;
 
  KMail::HtmlWriter * mHtmlWriter;
  std::map<TQCString,KMail::Interface::BodyPartMemento*> mBodyPartMementoMap;
  // an attachment should be updated
  bool mAtmUpdate;
  int mChoice;
  unsigned long mWaitingForSerNum;
  float mSavedRelativePosition;
  int mLevelQuote;
  bool mDecrytMessageOverwrite;
  bool mShowSignatureDetails;
  bool mShowAttachmentQuicklist;
  bool mShowRawToltecMail;
  bool mExternalWindow;
};
 
 
#endif