qzq_area.hpp

/* qzq_area.hpp */
/* $Id: qzq_area.hpp 20080 2009-12-15 15:57:52Z vlad $ */
#ifndef __qzq_area_hpp
#define __qzq_area_hpp

#include <QWidget>
#include <QTimer>
#include <QPixmap>

#include "zq_object.hpp"
#include "zqb_pixgroup.hpp"
#include "zqb_placeholder.hpp"
#include "zqb_natgrpmember.hpp"

#include "zqb_long_job_processor.hpp"

class QzqDynamicTip;
class QMainWindow;
class QzqAreaPainter;

class QzqArea : public QWidget, public ZqbLongJobProcessor
{
  Q_OBJECT
  
  friend class QzqAreaPainter;
  
public:

  QzqArea (QWidget *parent = NULL, const char* name = NULL, Qt::WFlags f = 0);

  virtual ~QzqArea ();
  
  void setDrawable(const bool drawable = true) {m_drawable = drawable;}


  /*
   *  Built-in placeholder container
   */
  
  ZqbPlaceholder*   placeholder ();

  const ZqbPlaceholder* placeholder () const;


  /*
   *  Visible functionality (small difference from ZqbVisible)
   */

  virtual void      redraw (bool bForce = false,
                QPaintDevice* pdev = NULL);

  virtual void      redrawOnSetCoord (ZqbNatGroup* pNatGrp);

  virtual bool      isHardcopy () const;


  virtual ZqbEventHint  input (QEvent* qev);

  virtual bool      updateGeometry (QPainter* paint = NULL,
                    bool bForce = false,
                    QRect *pCustomRect = NULL);

  virtual bool      tip (const QPoint& p,
                 QString& qsShort, QString& qsLong);


  virtual void      interactiveRedraw ();


  enum DrawObjectSelection {
    DrawAll,        
    DrawNonInteractive, 
    DrawInteractive 
  };

  DrawObjectSelection   getDrawObjectSelection () const;
  
  void setDrawObjectSelection (const DrawObjectSelection &mode);

  QMainWindow*  getMainWindow () const;

  void setBackgroundColor(const QColor &color) {m_bg_color = color;}

  const QColor& getBackgroundColor() const {return m_bg_color;}


  virtual void startLongJob() const;
  virtual void finishLongJob() const;
  virtual void longJobProgerss(double progress);
  
signals:
  
  void toolTipDelivered(const QString& qsShort, const QString& qsLong);

protected slots:

  void resizeEventTimeout();

protected:

  /*
   *  Built-in placeholder and related functionality
   */

  ZqbPixGroup       m_pgx;

  ZqbPixGroup       m_pgy;

  ZqbContainer      m_Container;

  ZqObject      *m_pGrabber;

  ZqbPlaceholder    m_AreaPh;

  QPainter      m_qPainter;

  QColor m_bg_color;

  QPixmap       m_qPixBuf;

  QzqDynamicTip     *m_qDynTip;

  ZqbNatGrpMembers  m_vObservers;
  
  QPixmap       m_qStaticPixBuf;

  DrawObjectSelection   m_eDrawObjectSelection;
  
  bool m_drawable;
  
  /*
   *  Event processing
   */
  virtual void  mousePressEvent (QMouseEvent* qev);
  virtual void  mouseReleaseEvent (QMouseEvent* qev);
  virtual void  mouseDoubleClickEvent (QMouseEvent* qev);
  virtual void  mouseMoveEvent (QMouseEvent* qev);
  virtual void  wheelEvent (QWheelEvent* qev);
  virtual void  keyPressEvent (QKeyEvent* qev);
  virtual void  keyReleaseEvent (QKeyEvent* qev);
  virtual void  enterEvent (QEvent* qev);
  virtual void  leaveEvent (QEvent* qev);
  virtual void  resizeEvent (QResizeEvent* qev);
   virtual void paintEvent (QPaintEvent* qev);
  virtual bool  event (QEvent* qev);
  
private:
    
  QzqAreaPainter *mp_area_painter;

  mutable QTimer m_timer;
  
  void redraw_impl(bool bForce = false,
           QPaintDevice *pd = NULL);
  
  void interactiveRedraw_impl();
};

#endif /* qzq_area.hpp */