VP1GraphicsItemCollection Class Reference

#include <VP1GraphicsItemCollection.h>

Inheritance diagram for VP1GraphicsItemCollection:

Collaboration diagram for VP1GraphicsItemCollection:

Classes
class	Imp

Public Types
enum	INTERACTIONMODE { INERT, SINGLEPICKS, EVENTS, SELECTIONS }

Signals
void	itemPicked (QGraphicsItem *) const
void	itemGotEvent (QGraphicsItem *, QEvent *) const
void	selectionChanged (QList< QGraphicsItem * >) const

Public Member Functions
	VP1GraphicsItemCollection (QObject *parent=0)
virtual	~VP1GraphicsItemCollection ()
void	setInteractionMode (const INTERACTIONMODE &)
INTERACTIONMODE	interactionMode () const
void	addItem (QGraphicsItem *, const bool &active=false, const bool &movable=false)
bool	setActive (QGraphicsItem *, const bool &active=true)
bool	setMovable (QGraphicsItem *item, const bool &movable=true)
bool	removeItem (QGraphicsItem *)
bool	hasItem (QGraphicsItem *) const
void	clear (const bool &deleteitems=true)
void	detachFromView ()
void	reattachToView ()
bool	isAttachedToView ()
int	nItems () const
int	nActiveItems () const
int	nMovableItems () const
int	nPresentlyActiveItems () const
int	nPresentlyMovableItems () const
bool	itemBelongsAndIsPresentlyActive (QGraphicsItem *) const

Private Member Functions
	VP1GraphicsItemCollection (const VP1GraphicsItemCollection &)
VP1GraphicsItemCollection &	operator= (const VP1GraphicsItemCollection &)
void	attachToView (VP1GraphicsView *)
void	real_detachFromView ()
void	setTemporaryIgnoreInteractions (const bool &)
void	setTemporaryIgnoreMovable (const bool &)
void	itemPickedPrivate (QGraphicsItem *) const
void	itemGotEventPrivate (QGraphicsItem *, QEvent *) const
void	selectionChangedPrivate (QList< QGraphicsItem * >) const

Private Attributes
Imp *	m_d

Friends
class	VP1GraphicsView

Detailed Description

Definition at line 53 of file VP1GraphicsItemCollection.h.

Member Enumeration Documentation

INTERACTIONMODE

enum VP1GraphicsItemCollection::INTERACTIONMODE

Enumerator
INERT
SINGLEPICKS
EVENTS
SELECTIONS

Definition at line 62 of file VP1GraphicsItemCollection.h.

{ INERT, SINGLEPICKS, EVENTS, SELECTIONS };

Constructor & Destructor Documentation

VP1GraphicsItemCollection() [1/2]

VP1GraphicsItemCollection::VP1GraphicsItemCollection

(

QObject *

parent = 0

)

Definition at line 55 of file VP1GraphicsItemCollection.cxx.

 : QObject(parent), m_d(new Imp)
{
  m_d->view=0;
  m_d->lastview=0;
  m_d->scene=0;
  m_d->ignoreall_int=false;
  m_d->ignoreall_move=false;
  m_d->interactionmode=INERT;
  m_d->nactiveitems=0;
}

~VP1GraphicsItemCollection()

VP1GraphicsItemCollection::~VP1GraphicsItemCollection ( )

virtual

Definition at line 68 of file VP1GraphicsItemCollection.cxx.

{
  if (m_d->view)
    detachFromView();
  clear();
  delete m_d;
}

VP1GraphicsItemCollection() [2/2]

VP1GraphicsItemCollection::VP1GraphicsItemCollection ( const VP1GraphicsItemCollection &  )

private

Member Function Documentation

addItem()

void VP1GraphicsItemCollection::addItem	(	QGraphicsItem *	item,
		const bool &	active = false,
		const bool &	movable = false
	)

Definition at line 94 of file VP1GraphicsItemCollection.cxx.

{
  assert(!m_d->items2active.contains(item)&&"Please do not add the same item twice");
  assert(!item->flags()&&"Please do not add any flags to your items!!");
 
  if (m_d->scene) {
    //The following must postponed if there is no scene:
    m_d->scene->addItem(item);
    item->setFlag(QGraphicsItem::ItemIsMovable,(movable&&(!m_d->ignoreall_move)));
  }
  assert(!m_d->items2active.contains(item));
  m_d->items2active.insert(item,active);
  if (active)
    ++m_d->nactiveitems;
  if (movable)
    m_d->movableitems<<item;
}

attachToView()

void VP1GraphicsItemCollection::attachToView ( VP1GraphicsView *  view )

private

Definition at line 240 of file VP1GraphicsItemCollection.cxx.

{
  assert(!m_d->scene);
  assert(!m_d->view);
  m_d->scene=view->scene();
  //  m_d->lastscene=m_d->scene;
  m_d->view=view;
  m_d->lastview=m_d->view;
  Imp::ItemDataMapItr it,itE=m_d->items2active.end();
  for (it=m_d->items2active.begin();it!=itE;++it) {
    m_d->scene->addItem(it.key());
  }
  //Update this, since we didnt do any updates while there was no scene:
  m_d->setEnabledMovableItems(!m_d->ignoreall_move);
}

clear()

void VP1GraphicsItemCollection::clear

(

const bool &

deleteitems = true

)

Definition at line 175 of file VP1GraphicsItemCollection.cxx.

{
  //Clear selections before deleting items in order to only get one selectionchanged signal.
  if (m_d->view)
    m_d->view->clearSelections();
 
  Imp::ItemDataMapItr it,itE=m_d->items2active.end();
  if (m_d->scene) {
    //Remove item from scene and possible also remove event filter.
    for (it=m_d->items2active.begin();it!=itE;++it)
      m_d->scene->removeItem(it.key());
  }
  if (deleteitems) {
    //Delete the items:
    for (it=m_d->items2active.begin();it!=itE;++it) {
      delete it.key();
    }
  }
  m_d->items2active.clear();
  m_d->movableitems.clear();
  m_d->nactiveitems=0;
}

detachFromView()

void VP1GraphicsItemCollection::detachFromView

(

)

Definition at line 257 of file VP1GraphicsItemCollection.cxx.

{
  if (!m_d->view)
    return;
  m_d->view->removeItemCollection(this);
  //NB. The call to removeItemCollection ends up by calling
  //VP1GraphicsItemCollection::real_detachFromView().
}

hasItem()

bool VP1GraphicsItemCollection::hasItem

(

QGraphicsItem *

item

)

const

Definition at line 199 of file VP1GraphicsItemCollection.cxx.

{
  return m_d->items2active.contains(item);
}

interactionMode()

VP1GraphicsItemCollection::INTERACTIONMODE VP1GraphicsItemCollection::interactionMode

(

)

const

Definition at line 88 of file VP1GraphicsItemCollection.cxx.

{
  return m_d->interactionmode;
}

isAttachedToView()

bool VP1GraphicsItemCollection::isAttachedToView

(

)

Definition at line 293 of file VP1GraphicsItemCollection.cxx.

{
  return m_d->view;
}

itemBelongsAndIsPresentlyActive()

bool VP1GraphicsItemCollection::itemBelongsAndIsPresentlyActive

(

QGraphicsItem *

item

)

const

Definition at line 330 of file VP1GraphicsItemCollection.cxx.

{
  if (!nPresentlyActiveItems())
    return false;
  QHash<QGraphicsItem*,bool>::const_iterator it = m_d->items2active.find(item);
 
 
  if (it==m_d->items2active.constEnd())
    return false;
  else
    return it.value();
}

itemGotEvent

void VP1GraphicsItemCollection::itemGotEvent ( QGraphicsItem *  , QEvent *    ) const

signal

itemGotEventPrivate()

void VP1GraphicsItemCollection::itemGotEventPrivate ( QGraphicsItem *  item, QEvent *  event  ) const

private

Definition at line 350 of file VP1GraphicsItemCollection.cxx.

{
  itemGotEvent(item,event);
}

itemPicked

void VP1GraphicsItemCollection::itemPicked ( QGraphicsItem *  ) const

signal

itemPickedPrivate()

void VP1GraphicsItemCollection::itemPickedPrivate ( QGraphicsItem *  item ) const

private

Definition at line 344 of file VP1GraphicsItemCollection.cxx.

{
  itemPicked(item);
}

nActiveItems()

int VP1GraphicsItemCollection::nActiveItems

(

)

const

Definition at line 306 of file VP1GraphicsItemCollection.cxx.

{
  return m_d->nactiveitems;
}

nItems()

int VP1GraphicsItemCollection::nItems

(

)

const

Definition at line 300 of file VP1GraphicsItemCollection.cxx.

{
  return m_d->items2active.count();
}

nMovableItems()

int VP1GraphicsItemCollection::nMovableItems

(

)

const

Definition at line 312 of file VP1GraphicsItemCollection.cxx.

{
  return m_d->movableitems.count();
}

nPresentlyActiveItems()

int VP1GraphicsItemCollection::nPresentlyActiveItems

(

)

const

Definition at line 318 of file VP1GraphicsItemCollection.cxx.

{
  return m_d->ignoresInteractions() ? 0 : m_d->nactiveitems;
}

nPresentlyMovableItems()

int VP1GraphicsItemCollection::nPresentlyMovableItems

(

)

const

Definition at line 324 of file VP1GraphicsItemCollection.cxx.

{
  return m_d->ignoresInteractions() ? 0 : m_d->movableitems.count();
}

operator=()

VP1GraphicsItemCollection& VP1GraphicsItemCollection::operator= ( const VP1GraphicsItemCollection &  )

private

real_detachFromView()

void VP1GraphicsItemCollection::real_detachFromView ( )

private

Definition at line 267 of file VP1GraphicsItemCollection.cxx.

{
  //This method is called after the collection has been removed from the the view.
  if (!m_d->view)
    return;
  //Remove item from scene:
  Imp::ItemDataMapItr it,itE=m_d->items2active.end();
  for (it=m_d->items2active.begin();it!=itE;++it) {
    m_d->scene->removeItem(it.key());
  }
  m_d->view=0;
  m_d->scene=0;
}

reattachToView()

void VP1GraphicsItemCollection::reattachToView

(

)

Definition at line 282 of file VP1GraphicsItemCollection.cxx.

{
  if (m_d->view)
    return;
  assert(m_d->lastview);
  m_d->lastview->addItemCollection(this);
  //NB. The call to addItemCollection ends up by calling
  //VP1GraphicsItemCollection::attachToView().
}

removeItem()

bool VP1GraphicsItemCollection::removeItem

(

QGraphicsItem *

item

)

Definition at line 115 of file VP1GraphicsItemCollection.cxx.

{
  Imp::ItemDataMapItr it = m_d->items2active.find( item );
  if (it==m_d->items2active.end())
    return false;
  if (it.value())
    --m_d->nactiveitems;
  if (m_d->scene) {
    m_d->scene->removeItem(item);
  }
  m_d->items2active.erase(it);
  assert(!m_d->items2active.contains(item));
 
  if (!m_d->movableitems.empty()) {
    QSet<QGraphicsItem*>::iterator it2 = m_d->movableitems.find(item);
    if (it2!=m_d->movableitems.end()) {
      assert(m_d->movableitems.contains(item));
      m_d->movableitems.erase(it2);
    }
  }
  assert(!m_d->movableitems.contains(item));
  return true;
}

selectionChanged

void VP1GraphicsItemCollection::selectionChanged ( QList< QGraphicsItem * >  ) const

signal

selectionChangedPrivate()

void VP1GraphicsItemCollection::selectionChangedPrivate ( QList< QGraphicsItem * >  items ) const

private

Definition at line 356 of file VP1GraphicsItemCollection.cxx.

{
  selectionChanged(items);
}

setActive()

bool VP1GraphicsItemCollection::setActive	(	QGraphicsItem *	item,
		const bool &	active = true
	)

Definition at line 161 of file VP1GraphicsItemCollection.cxx.

{
  Imp::ItemDataMapItr it = m_d->items2active.find( item );
  if (it==m_d->items2active.end())
    return false;
  it.value()=active;
  if (active)
    ++m_d->nactiveitems;
  else
    --m_d->nactiveitems;
  return true;
}

setInteractionMode()

void VP1GraphicsItemCollection::setInteractionMode

(

const INTERACTIONMODE &

im

)

Definition at line 77 of file VP1GraphicsItemCollection.cxx.

{
  assert(!m_d->scene&&"VP1GraphicsItemCollection::setInteractionMode can not be called while a scene is attached.");
  if (m_d->scene) {
    std::cout<<"VP1GraphicsItemCollection::setInteractionMode can not be called while a scene is attached."<<std::endl;
    return;
  }
  m_d->interactionmode = im;
}

setMovable()

bool VP1GraphicsItemCollection::setMovable	(	QGraphicsItem *	item,
		const bool &	movable = true
	)

Definition at line 140 of file VP1GraphicsItemCollection.cxx.

{
  Imp::ItemDataMapItr it = m_d->items2active.find( item );
  if (it==m_d->items2active.end())
    return false;
  if (movable==m_d->movableitems.contains(item))//Nothing needs to be done:
    return true;
  if (movable) {
    assert(!m_d->movableitems.contains(item));
    m_d->movableitems<<item;
  } else {
    assert(m_d->movableitems.contains(item));
    m_d->movableitems.remove(item);
    assert(!m_d->movableitems.contains(item));
  }
  if (!m_d->ignoreall_move)
    item->setFlag(QGraphicsItem::ItemIsMovable,movable);
  return true;
}

setTemporaryIgnoreInteractions()

void VP1GraphicsItemCollection::setTemporaryIgnoreInteractions ( const bool &  b )

private

Definition at line 216 of file VP1GraphicsItemCollection.cxx.

{
  if (m_d->ignoreall_int==b)
    return;
  m_d->ignoreall_int=b;
}

setTemporaryIgnoreMovable()

void VP1GraphicsItemCollection::setTemporaryIgnoreMovable ( const bool &  b )

private

Definition at line 224 of file VP1GraphicsItemCollection.cxx.

{
  if (m_d->ignoreall_move==b)
    return;
  m_d->ignoreall_move=b;
  if (m_d->scene)
    m_d->setEnabledMovableItems(!b);
}

Friends And Related Function Documentation

VP1GraphicsView

friend class VP1GraphicsView

friend

Definition at line 104 of file VP1GraphicsItemCollection.h.

Member Data Documentation

m_d

Imp* VP1GraphicsItemCollection::m_d

private

Definition at line 102 of file VP1GraphicsItemCollection.h.

---

The documentation for this class was generated from the following files:

• VP1GraphicsItemCollection.h
• VP1GraphicsItemCollection.cxx