Base object class ListBase managing a number of BaseItem objects. More...

#include <mlListBase.h>

Inheritance diagram for ml::ListBase:

Public Member Functions
	ListBase (bool persistence)
	Constructor. Derived class should indicate whether persistence is implemented.
	ListBase (const ListBase &other)
void	setContainer (ListContainerBase *container)
ListContainerBase *	getContainer () const
Abstract list access
virtual size_t	getSize () const =0
	Get number of list elements.
virtual BaseItem *	getItemAt (MLssize_t)
virtual const BaseItem *	getConstItemAt (MLssize_t) const
	Same as getItemAt(MLssize_t index) for constant access.
virtual void	insertItemAt (MLssize_t, const BaseItem *)
virtual void	modifyItemAt (MLssize_t, const BaseItem *)
virtual void	deleteItemAt (MLssize_t)
virtual void	selectItemAt (MLssize_t)
virtual const RuntimeType *	getItemTypeId () const
virtual void	clearList ()
	Clear complete list.
virtual ListBase *	clone () const
ListBase *	deepCopy () const override
	Create a deep copy of the list.
Public Member Functions inherited from ml::Base
	Base ()
	Constructor.
virtual	~Base ()
	Destructor.
bool	isOfAllowedType (const std::vector< const RuntimeType * > &types) const
virtual bool	isRefCountedBase () const
	Returns whether the instance is derived from RefCountedBase.
virtual std::string	detailString () const
virtual bool	implementsPersistence (PersistenceInterface) const
virtual std::string	persistentState () const
	Returns a string describing the object's internal state.
virtual void	setPersistentState (const std::string &state)
virtual void	writeTo (AbstractPersistenceOutputStream *) const
virtual void	readFrom (AbstractPersistenceInputStream *, int)

Protected Member Functions
char *	newString (const std::string &str) const
void	deleteString (char *str) const
	Dispose a string allocated with newString().
ListBase &	operator= (const ListBase &list)
	Assignment operator, used in derived list classes.

Last action performed on list
When different modules share a common list object, they can use a description of the last action performed on the list to synchronize themselves. Such a description consists of an action class, the id and the list index of the affected list item. The id can store a constant value uniquely identifying an item within a list. Some actions do not refer to a single list item, in which case id and index should be set to -1. In addition, the list maintains the index of the currently selected item, which can be set by setAction(ActSelect, ...) and which is updated when other operations are performed on the list.
enum	ActionClass { ActNone = 0 , ActUnknown , ActNew , ActSelect , ActModify , ActDelete , ActInsert , ActInsertOvw , ActNumActions }
	Constants to describe the type of action most recently performed. More...
static const char *const	ActionClassNames [ActNumActions]
	Action class name constants.
virtual void	setAction (ActionClass actionClass, MLssize_t id, MLssize_t index)
	Set actionClass, affected item id and index.
virtual void	setAction (ActionClass actionClass)
	Set actionClass for actions affecting the whole list.
virtual void	getAction (ActionClass &actionClass, MLssize_t &id, MLssize_t &index) const
	Get actionClass, affected item id and index.
virtual ActionClass	getActionClass () const
	Get actionClass of last action.
virtual MLssize_t	getActionId () const
	Get id of item affected by last action.
virtual MLssize_t	getActionIndex () const
virtual MLssize_t	getCurrentIndex () const
	Get index of currently selected item, or -1 if no item selected.
virtual bool	isModified () const
	Tests, if the last action has been an action that has modified the content of the list.

Persistence enable/disable and stream output
If persistence is enabled, the get/setPersistantState() methods of the derived ListTemplate classes iterate through all list items to get/set their state. If no persistence is implemented for the item class, persistence should be disabled to increase performance.
virtual bool	hasPersistence () const
	Test if persistence is available and enabled.
virtual void	setPersistence (bool persistence)
	Enable/disable persistence functionality.
bool	hasPersistance () const
void	setPersistance (bool persistence)
void	addStateToTree (TreeNode *parent) const override
	Attaches the state as children of the given parent node.
	ML_SET_ADDSTATE_VERSION (0)
	Set addState version number.
void	readStateFromTree (TreeNode *parent) override
	Reads the object state from the children of the given parent node.
MLBASEEXPORT friend std::ostream &	operator<< (std::ostream &s, const ListBase &list)
	Output persistent state to stream.

Additional Inherited Members
Public Types inherited from ml::Base
enum	PersistenceInterface { PersistenceByString , PersistenceByTreeNode , PersistenceByStream }
	This enum describes the different persistence interfaces available. More...

Detailed Description

Base object class ListBase managing a number of BaseItem objects.

Basic list class with functionality to

obtain the number of list elements
clear the list
enable/disable persistence
output persistent state to a stream
maintain a last action member variable, describing the most recent action performed on the list

Definition at line 63 of file mlListBase.h.

Member Enumeration Documentation

◆ ActionClass

enum ml::ListBase::ActionClass

Constants to describe the type of action most recently performed.

Enumerator
ActNone	No action.
ActUnknown	Unknown action.
ActNew	New list generated.
ActSelect	Changed the selection of the current list item. Deselect is represented by index == -1.
ActModify	Current list item modified.
ActDelete	List item deleted, _actionIndex contains index formerly occupied by deleted item.
ActInsert	List item inserted.
ActInsertOvw	List item inserted, first or last item deleted due to maximum list size restriction. _actionIndex contains index of inserted item, _actionId contains id of deleted item. NOTE: _actionId and _actionIndex refer to different items!
ActNumActions	Number of action classes, not to be used as valid enumerator!

Definition at line 201 of file mlListBase.h.

Constructor & Destructor Documentation

◆ ListBase() [1/2]

ml::ListBase::ListBase ( bool persistence )

inline

Constructor. Derived class should indicate whether persistence is implemented.

Definition at line 68 of file mlListBase.h.

References ActNew.

Referenced by ml::ListTemplate< T >::addStateToTree(), clone(), deepCopy(), ListBase(), ml::ListTemplate< T >::ListTemplate(), ml::ListTemplate< T >::ListTemplate(), ml::ListTemplate< T >::ListTemplate(), operator<<, operator=(), and ml::ListTemplate< T >::readStateFromTree().

◆ ListBase() [2/2]

ml::ListBase::ListBase ( const ListBase & other )

inline

Definition at line 77 of file mlListBase.h.

References getActionClass(), getActionId(), getActionIndex(), getCurrentIndex(), hasPersistence(), and ListBase().

Member Function Documentation

◆ addStateToTree()

void ml::ListBase::addStateToTree ( TreeNode * parent ) const

overridevirtual

Attaches the state as children of the given parent node.

Reimplemented from ml::Base.

Reimplemented in ml::ListTemplate< T >, ml::ListTemplate< BaseContainerItem >, ml::ListTemplate< BaseItem >, ml::ListTemplate< KeyFrame >, ml::ListTemplate< Matrix3 >, ml::ListTemplate< Matrix4 >, ml::ListTemplate< vec3i >, ml::ListTemplate< vec4i >, ml::ListTemplate< vec6i >, ml::ListTemplate< Vector3 >, ml::ListTemplate< Vector4 >, ml::ListTemplate< Vector6 >, and ml::ListTemplate< XMarker >.

◆ clearList()

virtual void ml::ListBase::clearList ( )

inlinevirtual

Clear complete list.

Definition at line 128 of file mlListBase.h.

References ActNew, and setAction().

Referenced by ml::ListTemplate< T >::clearList().

◆ clone()

virtual ListBase * ml::ListBase::clone ( ) const

inlinevirtual

Create a copy of (*this) using the ML runtime system and the '='-operator. Overwrite in derived classes if copying the list is not equivalent to copying the object (for instance, if the derived class has a global list description member). Returns NULL if a copy could not be created, or the cloned list otherwise. This function should not be called since it is overwritten by the clone()-method of ListTemplate<T>

Reimplemented in ml::ListTemplate< T >, ml::ListTemplate< BaseContainerItem >, ml::ListTemplate< BaseItem >, ml::ListTemplate< KeyFrame >, ml::ListTemplate< Matrix3 >, ml::ListTemplate< Matrix4 >, ml::ListTemplate< vec3i >, ml::ListTemplate< vec4i >, ml::ListTemplate< vec6i >, ml::ListTemplate< Vector3 >, ml::ListTemplate< Vector4 >, ml::ListTemplate< Vector6 >, and ml::ListTemplate< XMarker >.

Definition at line 137 of file mlListBase.h.

References ListBase().

Referenced by deepCopy().

◆ deepCopy()

ListBase * ml::ListBase::deepCopy ( ) const

inlineoverridevirtual

Create a deep copy of the list.

Reimplemented from ml::Base.

Reimplemented in ml::ListTemplate< T >, ml::ListTemplate< BaseContainerItem >, ml::ListTemplate< BaseItem >, ml::ListTemplate< KeyFrame >, ml::ListTemplate< Matrix3 >, ml::ListTemplate< Matrix4 >, ml::ListTemplate< vec3i >, ml::ListTemplate< vec4i >, ml::ListTemplate< vec6i >, ml::ListTemplate< Vector3 >, ml::ListTemplate< Vector4 >, ml::ListTemplate< Vector6 >, and ml::ListTemplate< XMarker >.

Definition at line 140 of file mlListBase.h.

References clone(), and ListBase().

◆ deleteItemAt()

virtual void ml::ListBase::deleteItemAt ( MLssize_t )

inlinevirtual

This virtual function is reimplemented in BaseListTemplate<T>, where it actually deletes the item at the given index. For list types that are NOT derived from BaseListTemplate<T>, and thus do not have BaseItem's as list items, nothing is done.

Reimplemented in ml::BaseListTemplate< T >, ml::BaseListTemplate< BaseContainerItem >, ml::BaseListTemplate< BaseItem >, and ml::BaseListTemplate< XMarker >.

Definition at line 115 of file mlListBase.h.

◆ deleteString()

void ml::ListBase::deleteString ( char * str ) const

inlineprotected

Dispose a string allocated with newString().

Definition at line 267 of file mlListBase.h.

References ml::ParserBase::deleteString().

◆ getAction()

virtual void ml::ListBase::getAction	(	ActionClass &	actionClass,
		MLssize_t &	id,
		MLssize_t &	index ) const

virtual

Get actionClass, affected item id and index.

◆ getActionClass()

virtual ActionClass ml::ListBase::getActionClass ( ) const

inlinevirtual

Get actionClass of last action.

Definition at line 233 of file mlListBase.h.

Referenced by ListBase().

◆ getActionId()

virtual MLssize_t ml::ListBase::getActionId ( ) const

inlinevirtual

Get id of item affected by last action.

Definition at line 237 of file mlListBase.h.

Referenced by ListBase().

◆ getActionIndex()

virtual MLssize_t ml::ListBase::getActionIndex ( ) const

inlinevirtual

Get index of item affected by last action. If last action was ActDelete, index refers to position before deleted item, or equals -1 if first item was deleted.

Definition at line 243 of file mlListBase.h.

Referenced by ListBase().

◆ getConstItemAt()

virtual const BaseItem * ml::ListBase::getConstItemAt ( MLssize_t ) const

inlinevirtual

Same as getItemAt(MLssize_t index) for constant access.

Reimplemented in ml::BaseListTemplate< T >, ml::BaseListTemplate< BaseContainerItem >, ml::BaseListTemplate< BaseItem >, and ml::BaseListTemplate< XMarker >.

Definition at line 100 of file mlListBase.h.

◆ getContainer()

ListContainerBase * ml::ListBase::getContainer ( ) const

inline

Definition at line 145 of file mlListBase.h.

◆ getCurrentIndex()

virtual MLssize_t ml::ListBase::getCurrentIndex ( ) const

inlinevirtual

Get index of currently selected item, or -1 if no item selected.

Definition at line 247 of file mlListBase.h.

Referenced by ListBase().

◆ getItemAt()

virtual BaseItem * ml::ListBase::getItemAt ( MLssize_t )

inlinevirtual

This virtual function is reimplemented in BaseListTemplate<T>, where it actually returns the item at the given index. For list types that are NOT derived from BaseListTemplate<T>, and thus do not have BaseItem's as list items, 0 is to be returned. Thus, this function can also be used to determine whether the list is actually derived from BaseListTemplate<T> (the runtime system can't help you with that because of the template).

Reimplemented in ml::BaseListTemplate< T >, ml::BaseListTemplate< BaseContainerItem >, ml::BaseListTemplate< BaseItem >, and ml::BaseListTemplate< XMarker >.

Definition at line 97 of file mlListBase.h.

◆ getItemTypeId()

virtual const RuntimeType * ml::ListBase::getItemTypeId ( ) const

inlinevirtual

This virtual function is reimplemented in BaseListTemplate<T>, where it actually returns the item class' type id. For list types that are NOT derived from BaseListTemplate<T>, and thus do not have BaseItem's as list items, NULL is returned.

Reimplemented in ml::BaseListTemplate< T >, ml::BaseListTemplate< BaseContainerItem >, ml::BaseListTemplate< BaseItem >, and ml::BaseListTemplate< XMarker >.

Definition at line 125 of file mlListBase.h.

◆ getSize()

virtual size_t ml::ListBase::getSize ( ) const

pure virtual

Get number of list elements.

Implemented in ml::ListTemplate< T >, ml::ListTemplate< BaseContainerItem >, ml::ListTemplate< BaseItem >, ml::ListTemplate< KeyFrame >, ml::ListTemplate< Matrix3 >, ml::ListTemplate< Matrix4 >, ml::ListTemplate< vec3i >, ml::ListTemplate< vec4i >, ml::ListTemplate< vec6i >, ml::ListTemplate< Vector3 >, ml::ListTemplate< Vector4 >, ml::ListTemplate< Vector6 >, and ml::ListTemplate< XMarker >.

◆ hasPersistance()

bool ml::ListBase::hasPersistance ( ) const

inline

Deprecated: Use hasPersistence() instead. Test if persistence is available and enabled

Definition at line 165 of file mlListBase.h.

References hasPersistence().

◆ hasPersistence()

virtual bool ml::ListBase::hasPersistence ( ) const

inlinevirtual

Test if persistence is available and enabled.

Definition at line 157 of file mlListBase.h.

Referenced by hasPersistance(), ListBase(), ml::ListTemplate< T >::persistentState(), ml::ListTemplate< T >::readStateFromTree(), and ml::ListTemplate< T >::setPersistentState().

◆ insertItemAt()

virtual void ml::ListBase::insertItemAt	(	MLssize_t	,
		const BaseItem *	)

inlinevirtual

This virtual function is reimplemented in BaseListTemplate<T>, where it actually inserts the item at the given index. For list types that are NOT derived from BaseListTemplate<T>, and thus do not have BaseItem's as list items, nothing is done.

Reimplemented in ml::BaseListTemplate< T >, ml::BaseListTemplate< BaseContainerItem >, ml::BaseListTemplate< BaseItem >, and ml::BaseListTemplate< XMarker >.

Definition at line 105 of file mlListBase.h.

◆ isModified()

virtual bool ml::ListBase::isModified ( ) const

inlinevirtual

Tests, if the last action has been an action that has modified the content of the list.

Definition at line 251 of file mlListBase.h.

References ActNone, and ActSelect.

◆ ML_SET_ADDSTATE_VERSION()

ml::ListBase::ML_SET_ADDSTATE_VERSION ( 0 )

Set addState version number.

◆ modifyItemAt()

virtual void ml::ListBase::modifyItemAt	(	MLssize_t	,
		const BaseItem *	)

inlinevirtual

This virtual function is reimplemented in BaseListTemplate<T>, where it actually modifies the item at the given index. For list types that are NOT derived from BaseListTemplate<T>, and thus do not have BaseItem's as list items, nothing is done.

Reimplemented in ml::BaseListTemplate< T >, ml::BaseListTemplate< BaseContainerItem >, ml::BaseListTemplate< BaseItem >, and ml::BaseListTemplate< XMarker >.

Definition at line 110 of file mlListBase.h.

◆ newString()

char * ml::ListBase::newString ( const std::string & str ) const

inlineprotected

Convenience method to create a copy of the string str allocated on the heap. This avoids passing STL strings between modules, which fails in Windows due to a bug in the VC++ implementation of the STL.

Definition at line 263 of file mlListBase.h.

References ml::ParserBase::newString().

◆ operator=()

ListBase & ml::ListBase::operator= ( const ListBase & list )

protected

Assignment operator, used in derived list classes.

References ListBase().

◆ readStateFromTree()

void ml::ListBase::readStateFromTree ( TreeNode * parent )

overridevirtual

Reads the object state from the children of the given parent node.

Reimplemented from ml::Base.

Reimplemented in ml::ListTemplate< T >, ml::ListTemplate< BaseContainerItem >, ml::ListTemplate< BaseItem >, ml::ListTemplate< KeyFrame >, ml::ListTemplate< Matrix3 >, ml::ListTemplate< Matrix4 >, ml::ListTemplate< vec3i >, ml::ListTemplate< vec4i >, ml::ListTemplate< vec6i >, ml::ListTemplate< Vector3 >, ml::ListTemplate< Vector4 >, ml::ListTemplate< Vector6 >, and ml::ListTemplate< XMarker >.

◆ selectItemAt()

virtual void ml::ListBase::selectItemAt ( MLssize_t )

inlinevirtual

This virtual function is reimplemented in BaseListTemplate<T>, where it actually selects the item at the given index. For list types that are NOT derived from BaseListTemplate<T>, and thus do not have BaseItem's as list items, nothing is done.

Reimplemented in ml::BaseListTemplate< T >, ml::BaseListTemplate< BaseContainerItem >, ml::BaseListTemplate< BaseItem >, and ml::BaseListTemplate< XMarker >.

Definition at line 120 of file mlListBase.h.

◆ setAction() [1/2]

virtual void ml::ListBase::setAction ( ActionClass actionClass )

inlinevirtual

Set actionClass for actions affecting the whole list.

Definition at line 226 of file mlListBase.h.

References setAction().

◆ setAction() [2/2]

virtual void ml::ListBase::setAction	(	ActionClass	actionClass,
		MLssize_t	id,
		MLssize_t	index )

virtual

Set actionClass, affected item id and index.

Referenced by clearList(), ml::BaseListTemplate< T >::doDeleteItem(), ml::BaseListTemplate< T >::doInsertItem(), ml::BaseListTemplate< T >::doModifyItem(), ml::BaseListTemplate< T >::doSelectItem(), ml::BaseListTemplate< T >::readStateFromTree(), ml::ListTemplate< T >::readStateFromTree(), setAction(), and ml::ListTemplate< T >::setPersistentState().

◆ setContainer()

void ml::ListBase::setContainer ( ListContainerBase * container )

inline

Definition at line 144 of file mlListBase.h.

◆ setPersistance()

void ml::ListBase::setPersistance ( bool persistence )

inline

Deprecated: Use setPersistence(bool persistence) instead. Enable/disable persistence functionality

Definition at line 169 of file mlListBase.h.

References setPersistence().

◆ setPersistence()

virtual void ml::ListBase::setPersistence ( bool persistence )

inlinevirtual

Enable/disable persistence functionality.

Definition at line 160 of file mlListBase.h.

Referenced by setPersistance().

◆ operator<<

MLBASEEXPORT friend std::ostream & operator<<	(	std::ostream &	s,
		const ListBase &	list )

friend

Output persistent state to stream.

References ListBase(), and MLBASEEXPORT.

Member Data Documentation

◆ ActionClassNames

const char* const ml::ListBase::ActionClassNames[ActNumActions]

static

Action class name constants.

Definition at line 220 of file mlListBase.h.

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

MeVisLab/Standard/Sources/ML/MLBase/mlListBase.h

Public Member Functions

Protected Member Functions

Last action performed on list

Persistence enable/disable and stream output

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ ActionClass

Constructor & Destructor Documentation

◆ ListBase() [1/2]

◆ ListBase() [2/2]

Member Function Documentation

◆ addStateToTree()

◆ clearList()

◆ clone()

◆ deepCopy()

◆ deleteItemAt()

◆ deleteString()

◆ getAction()

◆ getActionClass()

◆ getActionId()

◆ getActionIndex()

◆ getConstItemAt()

◆ getContainer()

◆ getCurrentIndex()

◆ getItemAt()

◆ getItemTypeId()

◆ getSize()

◆ hasPersistance()

◆ hasPersistence()

◆ insertItemAt()

◆ isModified()

◆ ML_SET_ADDSTATE_VERSION()

◆ modifyItemAt()

◆ newString()

◆ operator=()

◆ readStateFromTree()

◆ selectItemAt()

◆ setAction() [1/2]

◆ setAction() [2/2]

◆ setContainer()

◆ setPersistance()

◆ setPersistence()

Friends And Related Symbol Documentation

◆ operator<<

Member Data Documentation

◆ ActionClassNames