zqb_placeholder.hpp

/* zqb_placeholder.hpp */
/* $Id: zqb_placeholder.hpp,v 1.11 2007/12/20 15:11:48 vlad Exp $ */
#ifndef __zqb_placeholder_hpp
#define __zqb_placeholder_hpp

#include <vector>

#include "zqb_cliplinebyrect.hpp"
#include "zqb_visible.hpp"
#include "zqb_container.hpp"
#include "zqb_autoname.hpp"
#include "zqb_pixgroup.hpp"
#include "zqb_objectarray.hpp"


class ZqbPlaceholder
  : virtual public ZqbAutoName, public ZqbVisible, public ZqbContainer
{
public:

  ZqbPlaceholder (ZqbContainer& container,
          ZqbPixGroup* pPGX, ZqbPixGroup* pPGY,
          const char* szPhName = NULL);

  virtual ~ZqbPlaceholder ();


  /*
   *  Visible properties
   */

  virtual void      redraw (QPainter& paint);

  virtual ZqbEventHint  input (QEvent& event);

  virtual void      updateLimits (QPainter* paint = NULL);

  virtual void      updateGeometry ();


  /*
   *  Qt links
   */

  virtual QPainter* getScreenPainter () const;

  virtual void      setScreenPainter (QPainter* pPainter);

  virtual QWidget*  getAreaWidget () const;

  virtual void      setAreaWidget (QWidget* pWidget);

  virtual QRect     getRect () const;


  /*
   *  Operations over objects.
   */

  virtual bool      addObject (ZqObject* obj);

  virtual bool      removeObject (ZqObject* obj);

  virtual bool      toFront (ZqObject* obj);

  virtual bool      toBack (ZqObject* obj);

  virtual int       setDrawOrder (const ZqbObjectArray& objects);


  /*
   *  Geometry of the place (location and size)
   */

  bool          isPlaced () const;

  ZqbPixGrpMember   px;

  ZqbPixGrpMember   py;


  /*
   *  Clipping facility
   */

  bool      clipLine (int x[2], int y[2]);


  /*
   *  Flag of redrawing
   */

  void      setDirty ();

  void      resetDirty ();

  bool      isDirty () const;


  /*
   *  Flag to clear (fill with white color by default) the area under
   *  placeholder before drawing placeholder's objects
   */

  void      setAutoClear (bool bAutoClear);

  void      setAutoClear (bool bAutoClear, QColor qcFillColor);

  bool      getAutoClear (QColor* qcFillColor = NULL) const;

protected:

  ZqbContainer      &m_Container;

  QPainter      *m_pqPainter;

  QWidget       *m_pqWidget;

  ZqObject      *m_pGrabber;

  bool          m_bDirty;

  bool          m_bAutoClear;

  QColor        m_qcFillColor;

private:

  static int        m_iNameCounter;

};


typedef std::vector<ZqbPlaceholder*>    ZqbPlaceholderVector;


#endif /* zqb_placeholder.hpp */