summaryrefslogtreecommitdiffstats
path: root/kolourpaint/kpviewmanager.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commit47d455dd55be855e4cc691c32f687f723d9247ee (patch)
tree52e236aaa2576bdb3840ebede26619692fed6d7d /kolourpaint/kpviewmanager.h
downloadtdegraphics-47d455dd55be855e4cc691c32f687f723d9247ee.tar.gz
tdegraphics-47d455dd55be855e4cc691c32f687f723d9247ee.zip
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
Diffstat (limited to 'kolourpaint/kpviewmanager.h')
-rw-r--r--kolourpaint/kpviewmanager.h220
1 files changed, 220 insertions, 0 deletions
diff --git a/kolourpaint/kpviewmanager.h b/kolourpaint/kpviewmanager.h
new file mode 100644
index 00000000..c6ea1ef0
--- /dev/null
+++ b/kolourpaint/kpviewmanager.h
@@ -0,0 +1,220 @@
+
+/*
+ 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 __kpviewmanager_h__
+#define __kpviewmanager_h__
+
+#include <qcursor.h>
+#include <qobject.h>
+#include <qptrlist.h>
+#include <qrect.h>
+
+
+class QPixmap;
+class QRect;
+class QTimer;
+
+class kpDocument;
+class kpView;
+class kpMainWindow;
+class kpTempPixmap;
+
+class kpViewManager : public QObject
+{
+Q_OBJECT
+
+public:
+ kpViewManager (kpMainWindow *mainWindow);
+ ~kpViewManager ();
+
+
+ //
+ // Registering views
+ //
+
+ void registerView (kpView *view);
+ void unregisterView (kpView *view);
+ void unregisterAllViews ();
+
+
+ //
+ // Temp Pixmap
+ //
+
+ const kpTempPixmap *tempPixmap () const;
+ void setTempPixmap (const kpTempPixmap &tempPixmap);
+ void invalidateTempPixmap ();
+
+
+ //
+ // Selections
+ //
+
+ bool selectionBorderVisible () const;
+ void setSelectionBorderVisible (bool yes = true);
+
+ bool selectionBorderFinished () const;
+ void setSelectionBorderFinished (bool yes = true);
+
+
+ //
+ // Text Cursor
+ //
+
+ bool textCursorEnabled () const;
+ void setTextCursorEnabled (bool yes = true);
+
+ int textCursorRow () const;
+ int textCursorCol () const;
+ void setTextCursorPosition (int row, int col, bool isUpdateMicroFocusHint = false);
+
+ bool textCursorBlinkState () const;
+ void setTextCursorBlinkState (bool on = true);
+
+protected:
+ void updateTextCursor ();
+
+ QTimer *m_textCursorBlinkTimer;
+ int m_textCursorRow, m_textCursorCol;
+ bool m_textCursorBlinkState;
+
+protected slots:
+ void slotTextCursorBlink ();
+
+public:
+
+ //
+ // Cursors
+ //
+
+ void setCursor (const QCursor &cursor);
+ void unsetCursor ();
+
+
+ //
+ // View
+ //
+
+ kpView *viewUnderCursor (bool usingQt = false) const;
+
+ //
+ // QWidget::hasMouse() is unreliable:
+ //
+ // "bool QWidget::hasMouse () const
+ // ... See the "underMouse" property for details.
+ // .
+ // .
+ // .
+ // bool underMouse
+ // ... This value is not updated properly during drag and drop operations."
+ //
+ // i.e. it's possible that hasMouse() returns false in a mousePressEvent()!
+ //
+ // This hack needs to be called from kpView so that viewUnderCursor() works
+ // as a reasonable replacement (although there is at least one case where
+ // it still won't work - just after a fake drag onto the view).
+ //
+ void setViewUnderCursor (kpView *view);
+
+
+ // Returns a pointer to the view that has keyboard focus or else, 0
+ // TODO: rename to "anActiveView()" or "aViewIsActive()" as more than
+ // 1 view can be active at the same time?
+ kpView *activeView () const;
+
+
+ // Specifies whether KolourPaint will queue _all_ paint events
+ // (generated by you or the window system), until the
+ // corresponding call to restoreQueueUpdates(). Use this
+ // before multiple, big, non-interactive changes to the
+ // document to eliminate virtually all flicker.
+ //
+ // This is better than QWidget::setUpdatesEnabled() because
+ // restoreQueueUpdates() automatically restores only the regions
+ // of the views that need to be repainted, per view.
+ bool queueUpdates () const;
+ void setQueueUpdates ();
+ void restoreQueueUpdates ();
+
+ // Controls behaviour of updateViews():
+ //
+ // Slow: Let Qt buffer paint events via QWidget::update().
+ // Results in less flicker. Paint events are probably merged
+ // so long-term efficiency is increased at the expense of
+ // reduced responsiveness (default).
+ // Fast: Force Qt to redraw immediately. No paint events
+ // are merged so there is great potential for flicker,
+ // if used inappropriately. Use this when the redraw
+ // area is small and KolourPaint's responsiveness is
+ // critical. Continual use of this mode can result in
+ // unnecessary redraws and incredibly slugish performance.
+ bool fastUpdates () const;
+ void setFastUpdates ();
+ void restoreFastUpdates ();
+
+private:
+ int m_queueUpdatesCounter, m_fastUpdatesCounter;
+
+public slots:
+ // updating views
+ void updateView (kpView *v);
+ void updateView (kpView *v, const QRect &viewRect);
+ void updateView (kpView *v, int x, int y, int w, int h);
+ void updateView (kpView *v, const QRegion &viewRegion);
+ void updateViewRectangleEdges (kpView *v, const QRect &viewRect);
+
+ void updateViews ();
+ void updateViews (const QRect &docRect);
+ void updateViews (int x, int y, int w, int h);
+
+ void adjustViewsToEnvironment ();
+
+private:
+ // don't use
+ kpViewManager (const kpViewManager &);
+ bool operator= (const kpViewManager &);
+
+ kpDocument *document () const;
+
+ kpMainWindow *m_mainWindow;
+ QPtrList <kpView> m_views;
+ QCursor m_cursor;
+
+ kpTempPixmap *m_tempPixmap;
+ kpView *m_viewUnderCursor;
+
+ bool m_selectionBorderVisible;
+ bool m_selectionBorderFinished;
+
+ // There is no need to maintain binary compatibility at this stage.
+ // The d-pointer is just so that you can experiment without recompiling
+ // the kitchen sink.
+ class kpViewManagerPrivate *d;
+};
+
+#endif // __kpviewmanager_h__