Diffstat (limited to 'noncore/graphics/opie-eye/lib/oimagezoomer.h') (more/less context) (ignore whitespace changes)
| -rw-r--r-- | noncore/graphics/opie-eye/lib/oimagezoomer.h | 84 |
1 files changed, 76 insertions, 8 deletions
diff --git a/noncore/graphics/opie-eye/lib/oimagezoomer.h b/noncore/graphics/opie-eye/lib/oimagezoomer.h index 605416c..2516c61 100644 --- a/noncore/graphics/opie-eye/lib/oimagezoomer.h +++ b/noncore/graphics/opie-eye/lib/oimagezoomer.h @@ -15,8 +15,25 @@ namespace MM { /** - * \brief small class to zoom over a widget - * This class takes a QImage or QPixmap - * and gets the size of the original image - * and provides depending of this widgets size - * a zoomer and emits the region which should - * be shown / zoomed to + * \brief small class to zoom over a Page + * + * This class represents your page but smaller. + * It can draw a Rect on top of an Image/Pixmap you supply + * and you can allow the user easily zooming/moving + * over your widget. + * All you need to do is to supply a image/pixmap, the visible size + * and the original image/pixmap size and the current visible top/left + * position. + * + * This Image works perfectly with QScrollView as you can connect + * QScrollView::contentsMoving to setVisiblePoint slot and the zoomAreRel + * to the QScrollView::scrollBy slot. Now you would only need to watch + * the resize event anf give us the new information about QScrollView::viewport + * + * You need to position and set the size of this widget! using setFixedSize() is quite + * a good idea for this widget + * + * @see QScrollView + * @see QScrollView::viewport() + * + * @since 1.2 + * */ @@ -40,6 +57,32 @@ public slots: signals: - void zoomAreaRel( int,int ); - void zoomArea( int,int ); + /** + * Relative movement in the coordinates of the viewport + * This signal can easily be connected to QScrollView::scrollBy. + * This signal is emitted from within the mouseMoveEvent of this widget + * + * + * @param x The way to move relative on the X-Axis + * @param y The way to move relative on the Y-Axis + * + * @see setVisiblePoint + * @see QScrollView::scrollBy + */ + void zoomAreaRel( int x,int y); + + /** + * Here you get absolute coordinates. + * This slot will be emitted from within the mouseMoveEvent of this widget. + * So you may not delete this widget + * + * @param x The absolute X Coordinate to scroll to. + * @param y The absolute Y Coordinate to scroll to. + * + */ + void zoomArea( int x,int y); public: + /** + * make sure to call these if you reimplement + * @internal + */ void resizeEvent( QResizeEvent* ); @@ -47,4 +90,17 @@ public: protected: + /** + * make sure to call these if you reimplement + * @internal + */ void drawContents( QPainter* p ); + + /** + * make sure to call these if you reimplememt + * @internal + */ void mousePressEvent( QMouseEvent* ev ); + /** + * make sure to call these if you reimplement + * @internal + */ void mouseMoveEvent( QMouseEvent* ev ); @@ -52,2 +108,5 @@ protected: private: + /** + * @internal + */ void init(); @@ -59,2 +118,11 @@ private: +/** + * This slot is present for convience. You can connect the + * QScrollView::contentsMoved to this slot and it calls the QPoint + * version for you + * This realtes to QScrollView::contentsX() and QScrollView::contentsY() + * + * @param x The top left x coordinate + * @param y The top left y coorisnate + */ inline void OImageZoomer::setVisiblePoint( int x, int y ) { |