Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdegraphics@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 193 insertions, 0 deletions

diff --git a/kviewshell/documentWidget.h b/kviewshell/documentWidget.h
new file mode 100644
index 00000000..50f2ee44
--- /dev/null
+++ b/kviewshell/documentWidget.h
@@ -0,0 +1,193 @@
+// -*- C++ -*-
+//
+// Class: documentWidet
+//
+// Widget for displaying TeX DVI files.
+// Part of KDVI- A previewer for TeX DVI files.
+//
+// (C) 2004 Stefan Kebekus.
+// Copyright (C) 2004-2005 Wilfried Huss <Wilfried.Huss@gmx.at>
+//
+// Distributed under the GPL.
+
+#ifndef _documentwidget_h_
+#define _documentwidget_h_
+
+#include "selection.h"
+
+#include <qregion.h>
+#include <qtimer.h>
+#include <qwidget.h>
+
+class DocumentPageCache;
+class PageView;
+class QMouseEvent;
+class QPaintEvent;
+
+
+/* DocumentWidget */
+
+class DocumentWidget : public QWidget
+{
+  Q_OBJECT
+
+public:
+  DocumentWidget(QWidget *parent, PageView *sv, DocumentPageCache *cache, const char *name);
+
+  void          setPageNumber(Q_UINT16 pageNr);
+  Q_UINT16      getPageNumber() const {return pageNr;}
+
+  /** Returns the size of the widget without the page shadow. */
+  QSize pageSize() const;
+  /** Returns the bounding rectangle of the widget without the page shadow. */
+  QRect pageRect() const;
+
+  /** Draw a red vertical line at y-coordinate ycoord. The line is removed again 
+      after one second. This is used to make it easier to regain reading focus if
+      the whole page is scrolled up or down. */
+  void drawScrollGuide(int ycoord);
+
+  /** Checks if the page is currently visible in the PageView. */
+  bool isVisible();
+
+public slots:
+  void          slotEnableMoveTool(bool enable);
+
+  void          select(const TextSelection&);
+  void          selectAll();
+  void          flash(int);
+
+  /** Sets the size of the widget so that the page is of the given size.
+      The widget gets slightly bigger because of the page shadow. */
+  void setPageSize(const QSize&);
+  void setPageSize(int width, int height);
+
+signals:
+  /** Passed through to the top-level kpart. */
+  void          setStatusBarText( const QString& );
+  void          localLink( const QString& );
+
+  /** This signal is emitted when the widget resizes itself */
+  void          resized();
+
+  /** This signal is emitted when the selection needs to be cleared. */
+  void clearSelection();
+
+protected:
+  virtual void  paintEvent (QPaintEvent *);
+  virtual void  mousePressEvent ( QMouseEvent * e );
+  virtual void  mouseReleaseEvent (QMouseEvent *);
+
+  /** This method is used by the DocumentWidget to find out of the
+      mouse pointer hovers over a hyperlink, and to update the
+      statusbar accordingly. Scrolling with the left mouse button
+      pressed, and the text copy functions are also implemented here. 
+      Re-implementations of this method should do the following:
+      
+      0) Immediately return if pageNr == 0, i.e. if no page number has
+         been set
+
+      1) Call the standard implementation using
+	  
+	  DocumentWidget::mouseMoveEvent(e);
+
+      2) Ignore the QMouseEvent if a mouse button is pressed
+
+      3) If no mouse button is pressed, analyze the mouse movement and
+         take appropriate actions. To set statusbar text, do
+	 
+	 clearStatusBarTimer.stop();
+	 emit setStatusBarText( i18n("Whatever string") );
+
+	 To clear the statusbar, use the following code
+
+	 if (!clearStatusBarTimer.isActive())
+	   clearStatusBarTimer.start(200, true);
+
+	 This clears the statusbar after 200 msec and avoids awful
+	 flickering when the mouse is swiftly moved across various
+	 areas in the widget.
+
+  */
+  virtual void  mouseMoveEvent (QMouseEvent *);
+
+protected:
+  void updateSelection(const TextSelection& newTextSelection);
+
+  /** Methods and counters used for the animation to mark the target of
+      an hyperlink. */
+  int           timerIdent;
+  void          timerEvent( QTimerEvent *e );
+  int           animationCounter;
+  int           flashOffset;
+
+  Q_UINT16      pageNr;
+
+  /* This timer is used to delay clearing of the statusbar. Clearing
+     the statusbar is delayed to avoid awful flickering when the mouse
+     moves over a block of text that contains source hyperlinks. The
+     signal timeout() is connected to the method clearStatusBar() of
+     *this. */
+  QTimer        clearStatusBarTimer;
+
+  /* Data structures used for marking text with the mouse */
+  QPoint       firstSelectedPoint;
+  QRect        selectedRectangle;
+
+  /** Pointer to the PageView that contains this
+      widget. This pointer is used in the re-implementation of the
+      paintEvent() method ---see the explanation there. */
+  PageView *scrollView;
+  DocumentPageCache *documentCache;
+
+  /** Currently selected Region */
+  QRegion selectedRegion;
+
+  /** This is set to the index of the link over which the mouse pointer currently resides,
+      and -1 if the no link is hovered.
+      Is used when "Underline Links" is set to "Only on Hover". */
+  int indexOfUnderlinedLink;
+
+  /** True if there is already a request for this page to the renderer. */
+  bool pixmapRequested;
+
+  /** Sets the cursor to an arrow if the move tool is selected, and to the text selection
+      cursor if the selection tool is active. */
+  virtual void setStandardCursor();
+
+private slots:
+  /** This slot emits the signal setStatusBarText(QString::null) to
+      clear the status bar. It is connected to the timeout slot of the
+      clearStatusBarTimer. */
+  void clearStatusBar();
+
+  void delayedRequestPage();
+
+  /** Hide the scroll guide. This slot is called one second after drawScrollGuide(). */
+  void clearScrollGuide();
+
+private:
+  QRect linkFlashRect();
+
+  /** If this variable is positive draw a vertical line at this y-coordinate. */
+  int scrollGuide;
+
+  /** Color used by in the shadow drawing to check if the background color has been changed. */
+  static QColor backgroundColorForCorners;
+
+  /** The following tables store grey values for roundish shadow
+      corners. They were shamelessly stolen from kdelibs/kdefx/kstyle.cpp. */
+  static const int bottom_right_corner[16];
+  static const int bottom_left_corner[16];
+  static const int shadow_strip[4];
+
+  bool moveTool;
+
+  /** If this is true the zoomlevel has changed and we need to update the
+      selected region. */
+  bool selectionNeedsUpdating;
+};
+
+
+
+#endif