IlvGroupHolder Class Reference

Abstract base class for containers and managers holding IlvGroups. More...

#include <ilviews/protos/groupholder.h>

Inheritance diagram for IlvGroupHolder:

List of all members.

Public Member Functions
virtual void	addGroup (IlvGroup *group, IlBoolean unique=IlTrue)
	Adds an IlvGroup to the container or manager attached to the group holder.
virtual IlUInt	checkUniqueName (const char *name) const
	Checks that a given name is unique within an IlvGraphicHolder and returns the value used to provide the unique name if needed.
virtual IlvGroup *	getGroup (const char *name) const
	Returns the group with the name name.
virtual IlvGroup **	getGroups (IlUInt &count) const
	Returns all the groups contained in the holder.
virtual void	removeGroup (IlvGroup *group, IlBoolean destroy=IlFalse)
	Removes an IlvGroup from the container or manager attached to the group holder.
Static Public Member Functions
static IlvGroupHolder *	Get (IlvGraphicHolder *holder)
	Returns the group holder associated with the IlvGraphicHolder.
static IlvGroupHolder *	Get (IlvManager *mgr)
	See below.
static IlvGroupHolder *	Get (IlvContainer *ctn)
	See below.

---

Detailed Description

Abstract base class for containers and managers holding IlvGroups.

Library: ilvproto

This class lets you handle sets of IlvGroup objects in a container or manager. Classes of name IlvProto*[Container|Manager|Grapher] implement the same interface through specialized subclasses of IlvProtoHolderInterface.

See also:

IlvAccessorHolder, IlvGroup, IlvProtoGraphic, IlvContainer, IlvManager, IlvGrapher.

---

Member Function Documentation

virtual void IlvGroupHolder::addGroup	(	IlvGroup *	group,
		IlBoolean	unique = IlTrue
	)			[virtual]

Adds an IlvGroup to the container or manager attached to the group holder.

Parameters:

	group	IlvGroup to be added. If the manager or container does not handle group objects directly, the group will be encapsulated in an IlvProtoGraphic object. If the name of the group already exists, it will assign the group a unique name.
	unique	If set to IlTrue, the name of the group may be modified to ensure that the object name is unique.

See also:

IlvProtoGraphic, checkUniqueName.

virtual IlUInt IlvGroupHolder::checkUniqueName

(

const char *

name

)

const [virtual]

Checks that a given name is unique within an IlvGraphicHolder and returns the value used to provide the unique name if needed.

Parameters:

name

Name to be checked for uniqueness.

Returns:

0 if the name is unique. Otherwise, it returns an integer that, concatenated to the given name, will ensure the name is unique. For instance, if on input name is "IlvGroup" and there are already objects of name "IlvGroup" and "IlvGroup_1" in the holder, the method will return 2, indicating that the name "IlvGroup_2" is available to be assigned as a unique name.

static IlvGroupHolder* IlvGroupHolder::Get

(

IlvGraphicHolder *

holder

)

[static]

Returns the group holder associated with the IlvGraphicHolder.

Returns:

A group holder that is created and that lets you access all group objects associated with the IlvGraphicHolder. This holder will be deleted along with its associated container or manager if these are deleted.

See also:

IlvManager, IlvContainer.

virtual IlvGroup* IlvGroupHolder::getGroup

(

const char *

name

)

const [virtual]

Returns the group with the name name.

Parameters:

name

Name of the group to be retrieved. IlvGroup objects should have a unique name allowing them to be identified within a manager or container.

Returns:

The first group found with the name name, or 0 if none is found.

virtual IlvGroup** IlvGroupHolder::getGroups

(

IlUInt &

count

)

const [virtual]

Returns all the groups contained in the holder.

Parameters:

count

On return, this integer is set to the size of the returned array.

Returns:

An array of pointers to IlvGroup objects of size count. This array should be deleted with delete[] when it is no longer needed.

virtual void IlvGroupHolder::removeGroup	(	IlvGroup *	group,
		IlBoolean	destroy = IlFalse
	)			[virtual]

Removes an IlvGroup from the container or manager attached to the group holder.

Parameters:

	group	IlvGroup to be removed.
	destroy	If set to IlTrue, the group is destroyed.