src/can/canCanvasView.h

   1 /*
   2 Qanava - Graph drawing library for QT
   3 Copyright (C) 2005 Benoit AUTHEMAN
   4
   5 This program is free software; you can redistribute it and/or
   6 modify it under the terms of the GNU General Public License
   7 as published by the Free Software Foundation; either version 2
   8 of the License, or (at your option) any later version.
   9
  10 This program is distributed in the hope that it will be useful,
  11 but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 GNU General Public License for more details.
  14
  15 You should have received a copy of the GNU General Public License
  16 along with this program; if not, write to the Free Software
  17 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  18 */
  19
  20 //-----------------------------------------------------------------------------
  21 // This file is a part of the Qanava software.
  22 //
  23 // \file        canCanvasView.h
  24 // \author      Benoit Autheman (authem_b@epita.fr)
  25 // \date        2003 August 13
  26 //-----------------------------------------------------------------------------
  27
  28
  29 #ifndef canCanvasView_h
  30 #define canCanvasView_h
  31
  32
  33 // Qanava headers
  34 #include "canCanvas.h"
  35 #include "canGraphView.h"
  36
  37
  38 // STD headers
  39 #include <map>
  40
  41
  42 // QT headers
  43 #include <qobject.h>
  44 #include <qcanvas.h>
  45 #include <qcursor.h>
  46
  47
  48 //-----------------------------------------------------------------------------
  49 namespace qan { // ::qan
  50 namespace can { // ::qan::can
  51
  52         //! Provide a view on a specific canvas and manage user interaction with this canvas.
  53         /*!
  54                 \nosubgrouping
  55         */
  56         class CanvasView : public QCanvasView
  57         {
  58             Q_OBJECT
  59
  60                 /*! \name CanvasView Constructor/Destructor *///---------------------------
  61                 //@{
  62         public:
  63
  64                 CanvasView( QCanvas&, QWidget* parent = 0, const char* name = 0, WFlags f = 0 );
  65                 //@}
  66                 //---------------------------------------------------------------------
  67
  68
  69
  70                 /*! \name Tooltip Management *///--------------------------------------
  71                 //@{
  72         signals:
  73
  74                 void    nodeTipped( la::Node* node, QPoint p );
  75
  76                 void    nodeSelected( la::Node* node );
  77
  78         protected slots:
  79
  80                 void    tipTimeout( );
  81
  82         private:
  83
  84             QCanvasItem*                _tipItem;
  85
  86             QPoint                              _tipPos;
  87
  88                 QTimer*                         _timer;
  89                 //@}
  90                 //---------------------------------------------------------------------
  91
  92
  93
  94                 /*! \name Keyboard Navigation Management *///--------------------------
  95                 //@{
  96         protected:
  97
  98                 //! Enable or disable keyboard navigation (with arrow keys).
  99                 void                    setKeyboardNavigation( bool state );
 100
 101                 //! Get the current keyboard navigation state.
 102                 bool                    getKeyboardNavigation( ) const { return _keyboardNavigation; }
 103
 104                 virtual void    keyPressEvent( QKeyEvent* e );
 105
 106         private:
 107
 108                 //! Keyboard navigation state.
 109                 bool                    _keyboardNavigation;
 110
 111                 //! Keyboard navigation intensity.
 112                 double                  _keyboardNavigationIntensity;
 113                 //@}
 114                 //---------------------------------------------------------------------
 115
 116
 117
 118                 /*! \name Mouse Navigation Management *///-----------------------------
 119                 //@{
 120         protected:
 121
 122                 virtual void    contentsMousePressEvent( QMouseEvent* e );
 123
 124                 virtual void    contentsMouseReleaseEvent( QMouseEvent* e );
 125
 126                 virtual void    contentsMouseMoveEvent( QMouseEvent* e );
 127
 128                 virtual void    contentsMouseDoubleClickEvent( QMouseEvent* e );
 129
 130                 //! Enable or disable canvas dragging by mouse.
 131                 void                    setCanvasDrag( bool state ) { _canvasDrag = state; }
 132
 133         private:
 134
 135                 QCanvasItem*    _dragItem;
 136
 137                 QCanvasItem*    _currentItem;
 138
 139                 QPoint                  _dragStart;
 140
 141                 bool                    _mousePressed;
 142
 143                 QPoint                  _mousePressedStart;
 144
 145                 //! Canvas dragging enable state.
 146                 bool                    _canvasDrag;
 147                 //@}
 148                 //---------------------------------------------------------------------
 149
 150
 151
 152                 /*! \name Resize and Zoom Management *///------------------------------
 153                 //@{
 154         protected:
 155
 156                 virtual void    viewportResizeEvent( QResizeEvent* e );
 157
 158                 //! Set the maximum zoom factor that can be sets with the setZoomValue() method.
 159                 void                    setZoomMaxFactor( double zoomMaxFactor ) { _zoomMaxFactor = zoomMaxFactor; }
 160
 161         public slots:
 162
 163                 //! Set the current zoom factor value in percents (from 1 to 100, 100 sets the maximum zoom factor).
 164                 void                    setZoom( int value );
 165
 166         private:
 167
 168                 //! Maximum zoom factor (default = 2).
 169                 double                  _zoomMaxFactor;
 170                 //@}
 171                 //---------------------------------------------------------------------
 172         };
 173 } // ::qan::can
 174 } // ::qan
 175 //-----------------------------------------------------------------------------
 176
 177
 178 #endif // canCanvasView_h
 179