summaryrefslogtreecommitdiffstats
path: root/kolourpaint/kpviewscrollablecontainer.h
diff options
context:
space:
mode:
Diffstat (limited to 'kolourpaint/kpviewscrollablecontainer.h')
-rw-r--r--kolourpaint/kpviewscrollablecontainer.h255
1 files changed, 255 insertions, 0 deletions
diff --git a/kolourpaint/kpviewscrollablecontainer.h b/kolourpaint/kpviewscrollablecontainer.h
new file mode 100644
index 00000000..203bbd1f
--- /dev/null
+++ b/kolourpaint/kpviewscrollablecontainer.h
@@ -0,0 +1,255 @@
+
+/*
+ Copyright (c) 2003,2004,2005 Clarence Dang <dang@kde.org>
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+ IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+ IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+ INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+
+
+#ifndef KP_VIEW_SCROLLABLE_CONTAINER_H
+#define KP_VIEW_SCROLLABLE_CONTAINER_H
+
+
+#include <qpoint.h>
+#include <qscrollview.h>
+#include <qsize.h>
+
+
+class QCursor;
+class QRect;
+class QTimer;
+
+class kpGrip;
+class kpView;
+class kpMainWindow;
+
+
+// TODO: refactor by sharing iface's with kpTool
+class kpGrip : public QWidget
+{
+Q_OBJECT
+
+public:
+ enum GripType
+ {
+ Right = 1, Bottom = 2,
+ BottomRight = Right | Bottom
+ };
+
+ kpGrip (GripType type,
+ QWidget *parent, const char *name = 0);
+ virtual ~kpGrip ();
+
+ GripType type () const;
+
+ static const QCursor &cursorForType (GripType type);
+
+ QRect hotRect (bool toGlobal = false) const;
+
+ bool isDrawing () const;
+
+signals:
+ void beganDraw ();
+ void continuedDraw (int viewDX, int viewDY, bool dueToDragScroll);
+ void cancelledDraw ();
+ void endedDraw (int viewDX, int viewDY);
+
+ void statusMessageChanged (const QString &string);
+
+ void releasedAllButtons ();
+
+public:
+ QString haventBegunDrawUserMessage () const;
+
+ QString userMessage () const;
+ void setUserMessage (const QString &message);
+
+protected:
+ void updatePixmap ();
+ void cancel ();
+
+protected:
+ virtual void keyReleaseEvent (QKeyEvent *e);
+ virtual void mousePressEvent (QMouseEvent *e);
+public:
+ QPoint viewDeltaPoint () const;
+ void mouseMovedTo (const QPoint &point, bool dueToDragScroll);
+protected:
+ virtual void mouseMoveEvent (QMouseEvent *e);
+ virtual void mouseReleaseEvent (QMouseEvent *e);
+ virtual void resizeEvent (QResizeEvent *e);
+
+ virtual void enterEvent (QEvent *e);
+ virtual void leaveEvent (QEvent *e);
+
+ virtual void paintEvent (QPaintEvent *e);
+
+protected:
+ GripType m_type;
+ QPoint m_startPoint, m_currentPoint;
+ QString m_userMessage;
+ bool m_shouldReleaseMouseButtons;
+};
+
+
+class kpViewScrollableContainer : public QScrollView
+{
+Q_OBJECT
+
+public:
+ kpViewScrollableContainer (kpMainWindow *parent, const char *name = 0);
+ virtual ~kpViewScrollableContainer ();
+
+ // Same as contentsX() and contentsY() except that after
+ // contentsMovingSoon() is emitted and before the scrollview actually
+ // scrolls, they return the would be values of contentsX() and
+ // contentsY() after scrolling.
+ int contentsXSoon ();
+ int contentsYSoon ();
+
+signals:
+ // connect to this instead of contentsMoving(int,int) so that
+ // contentsXSoon() and contentsYSoon() work
+ void contentsMovingSoon (int contentsX, int contentsY);
+
+ void beganDocResize ();
+ void continuedDocResize (const QSize &size);
+ void cancelledDocResize ();
+ void endedDocResize (const QSize &size);
+
+ // (string.isEmpty() if kpViewScrollableContainer has nothing to say)
+ void statusMessageChanged (const QString &string);
+
+ void resized ();
+
+public:
+ QSize newDocSize () const;
+ bool haveMovedFromOriginalDocSize () const;
+ QString statusMessage () const;
+ void clearStatusMessage ();
+
+protected:
+ void connectGripSignals (kpGrip *grip);
+
+ QSize newDocSize (int viewDX, int viewDY) const;
+
+ void calculateDocResizingGrip ();
+ kpGrip *docResizingGrip () const;
+
+ int bottomResizeLineWidth () const;
+ int rightResizeLineWidth () const;
+
+ QRect bottomResizeLineRect () const;
+ QRect rightResizeLineRect () const;
+ QRect bottomRightResizeLineRect () const;
+
+ QPoint mapViewToViewport (const QPoint &viewPoint);
+ QRect mapViewToViewport (const QRect &viewRect);
+
+ QRect mapViewportToGlobal (const QRect &viewportRect);
+ QRect mapViewToGlobal (const QRect &viewRect);
+
+ void repaintWidgetAtResizeLineViewRect (QWidget *widget,
+ const QRect &resizeLineViewRect);
+ void repaintWidgetAtResizeLines (QWidget *widget);
+ void eraseResizeLines ();
+
+ void drawResizeLines ();
+
+ void updateResizeLines (int viewX, int viewY,
+ int viewDX, int viewDY);
+
+protected slots:
+ void slotGripBeganDraw ();
+ void slotGripContinuedDraw (int viewDX, int viewDY, bool dueToScrollView);
+ void slotGripCancelledDraw ();
+ void slotGripEndedDraw (int viewDX, int viewDY);
+
+ void slotGripStatusMessageChanged (const QString &string);
+
+public slots:
+ void recalculateStatusMessage ();
+
+protected slots:
+ void slotContentsMoving (int x, int y);
+ void slotContentsMoved ();
+
+protected:
+ void disconnectViewSignals ();
+ void connectViewSignals ();
+
+public:
+ // Calls setView(<widget>) after adding <widget> if it's a kpView.
+ virtual void addChild (QWidget *widget, int x = 0, int y = 0);
+
+ kpView *view () const;
+ void setView (kpView *view);
+
+public slots:
+ void updateGrips ();
+protected slots:
+ void slotViewDestroyed ();
+
+public slots:
+ // TODO: Why the QPoint's?
+ // Why the need for view's zoomLevel? We have the view() anyway.
+ bool beginDragScroll (const QPoint &, const QPoint &,
+ int zoomLevel,
+ bool *didSomething);
+ bool beginDragScroll (const QPoint &, const QPoint &,
+ int zoomLevel);
+ bool endDragScroll ();
+
+protected slots:
+ bool slotDragScroll (bool *didSomething);
+ bool slotDragScroll ();
+
+protected:
+ QRect noDragScrollRect () const;
+
+ virtual void contentsDragMoveEvent (QDragMoveEvent *e);
+ virtual void contentsMouseMoveEvent (QMouseEvent *e);
+ virtual void contentsWheelEvent (QWheelEvent *e);
+ virtual void mouseMoveEvent (QMouseEvent *e);
+ virtual bool eventFilter (QObject *watchedObject, QEvent *e);
+ virtual void viewportPaintEvent (QPaintEvent *e);
+ virtual void paintEvent (QPaintEvent *e);
+ virtual void resizeEvent (QResizeEvent *e);
+
+protected:
+ kpMainWindow *m_mainWindow;
+ int m_contentsXSoon, m_contentsYSoon;
+ kpView *m_view;
+ kpGrip *m_bottomGrip, *m_rightGrip, *m_bottomRightGrip;
+ kpGrip *m_docResizingGrip;
+ QTimer *m_dragScrollTimer;
+ int m_zoomLevel;
+ bool m_scrollTimerRunOnce;
+ int m_resizeRoundedLastViewX, m_resizeRoundedLastViewY;
+ int m_resizeRoundedLastViewDX, m_resizeRoundedLastViewDY;
+ bool m_haveMovedFromOriginalDocSize;
+ QString m_gripStatusMessage;
+};
+
+
+#endif // KP_VIEW_SCROLLABLE_CONTAINER_H