zqb_visible.hpp

/* zqb_visible.hpp */
/* $Id: zqb_visible.hpp,v 1.13 2007/10/17 08:53:33 vlad Exp $ */
#ifndef __zqb_visible_hpp
#define __zqb_visible_hpp

#include <qpainter.h>
#include <qwidget.h>


enum ZqbEventHint
{
  Z_EH_ACCEPT,  
  Z_EH_IGNORE,  
  Z_EH_GRAB 
};


class ZqbVisible
{
private:

  bool      m_bDrawable;

  bool      m_bInputable;

  bool      m_bTipable;

public:

  ZqbVisible (bool bDrawable = false, bool bInputable = false,
          bool bTipable = false)
    : m_bDrawable(bDrawable), m_bInputable(bInputable), m_bTipable(bTipable)
  {}

  virtual ~ZqbVisible ();


  /*
   *  Drawing
   */

  virtual void      redraw (QPainter& paint) = 0;

  virtual bool      isDrawable () const {
    return m_bDrawable;
  }

  virtual void      setDrawable (bool bFlag) {
    m_bDrawable = bFlag;
  }

  virtual void      redraw () {
    QPainter    *pPainter = getScreenPainter();
    if(NULL == pPainter)
      return;

    redraw(*pPainter);
  }

  virtual bool      isHardcopy () const {
    return false;
  }


  /*
   *  Flag of redrawing
   */

  virtual void      setDirty () = 0;

  virtual void      resetDirty () = 0;

  virtual bool      isDirty () const = 0;


  /*
   *  Dynamic tip facilities
   */

  virtual void      setTipable (bool bFlag) {
    m_bTipable = bFlag;
  }

  virtual bool      isTipable () const {
    return m_bTipable;
  }

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


  /*
   *  Events processing
   */

  virtual ZqbEventHint  input (QEvent& event) = 0;

  virtual bool      isInputable () const {
    return m_bInputable;
  }

  virtual void      setInputable (bool bFlag) {
    m_bInputable = bFlag;
  }


  /*
   *  Position and size properties
   */

  virtual void      updateGeometry () = 0;

  virtual void      updateLimits (QPainter* paint = NULL) = 0;

  virtual bool      getRect (QRect& ) {
    return false;
  }

  virtual bool      setRect (const QRect& ) {
    return false;
  }


  /*
   *  Qt links
   */

  virtual QPainter* getScreenPainter () const = 0;

  virtual void      setScreenPainter (QPainter* pPainter) = 0;

  virtual QWidget*  getAreaWidget () const = 0;

  virtual void      setAreaWidget (QWidget* pWidget) = 0;

};

#endif /* zqb_visible.hpp */