PackTreeCell Class Reference
[Base Type Serializable Classes]

#include <PackTreeCell.h>

Detailed Description

base type managing a Tree database of any PackSerializable (or inherited) Objects. the object type managed is unique and defined at construction, by passing a function that do return a new object.

Definition at line 19 of file PackTreeCell.h.

Public Types

enum eVedaUpdate {
  eVedaUpdate_NoUpdate = 0, eVedaUpdate_MemberIsGoingToChange, eVedaUpdate_MemberChanged, eVedaUpdate_MemberChangedBecauseOfUndo,
  eVedaUpdate_MemberDestroyed, eVedaUpdate_ObjectNew, eVedaUpdate_ObjectDestroyed, eVedaUpdate_ObjectReCreated,
  eVedaUpdate_ObjectClosed, eVedaUpdate_NewRegisteredClass
}

enum used by BaseContext::NotifyObjectChange() to describe the notification meaning. Used by interfaces to monitor a context. More...

Public Member Functions

PackTreeCell (BaseTypeCreatorCallBackFunction _func)

Constructor.

virtual ~PackTreeCell (void)

Destructor.

virtual const unsigned char * Serialize_In (const unsigned char *_pDescriptionChunk)

Read the object description from a byte chunk. Could crash if chunk not valid.

virtual unsigned int GetSerializedDescriptionSize (void)

get the size of the whole byte chunk that will be written by Serialize_Out().

virtual unsigned char * Serialize_Out (unsigned char *_pDescriptionChunkToFill)

write the Current object definition to a Chunk using private packed types, recursively.

virtual const char * GetClassID () const

Each BaseType's inherited classes must explicit an ID for their class, or let use one of the super class at least through this virtual method. This is needed by GUIs to detect the types of each sub-members, and shape an interface for each Object according to their member list.

virtual void SetObjectThatManagesThis (BaseObject *_pManager)

The Object this one belong to as a member. Should only be used at init.

PackTreeCell * AddSubCellToThisCell (int _indexWhereToInsert=-1)

Add a new sub cell element, at the given index, to this Cell.

BaseType * GetObject ()

Return a pointer on the BaseType managed by this cell:.

PackTreeCell * GetNextBrotherCell ()

get next brother cell in the hierarchy, or null if last of the brotherhood. It used to scan the tree.

PackTreeCell * GetFirstSubCell ()

get first subCell if there is any, or null if no subcell at all. It used to scan the tree.

void DeleteSubCells (PackTreeCell *_pSubCellToDelete)

delete an element and its whole sub elements. the first to delete can be at any level.

virtual unsigned int WriteFile (const char *_pFileName)

write a serialized form, using GetSerializedDescriptionSize() and Serialize_Out().

virtual unsigned int ReadFile (const char *_pFileName)

Try to read a serialized form, using Serialize_In().

void SetMemberName (const char *_MemberName)

Explicits the name of an object when used as a class member. It exists only in editable mode, and then can be used by any GUI. A member with an infoString not NULL, should be drawn in a GUI and receive updates. an object member with GetMemberName() returning NULL should not be edited by an interface or undo-managed. Use REGISTER_MEMBER macros family: it registers the members and use SetMemberName() automatically (or not, according to the compilation mode).

const char * GetMemberName () const

Explicits the name of an object when used as a class member. It exists only in editable mode, and then can be used by any GUI. A member with an infoString not NULL, should be drawn in a GUI and receive updates. an object member with GetMemberName() to NULL should not be edited by an interface or undo-managed. set with SetMemberName().

void SetMemberInfo (const char *_MemberInfo)

Explicits the use of an object when used as a class member. It should explain what the member does for the object. It exists only in editable mode,and can be used by any GUI. Don't use html tags , only \n are allowed. Use REGISTER_MEMBER_INFO macro after the REGISTER_MEMBER macro in the constructors. It can be left NULL.

const char * GetMemberInfo () const

Explicits the use of an object when used as a class member. It exists only in editable mode and can be used by any GUI. It should explain what the member does for the object.

virtual const char * ValueToString ()

convert the value of this object to an explicit string. The object manages the string privately, so just read it or copy it. the string would be destroyed with the objects, and changed when using Set() methods.

BaseObject * GetObjectThatManagesThis ()

If there is any, get the object that manages this one as a member.

void MakeCloneOf (BaseType &_ModelObject)

Tool that makes an object take the values of another using serialization. Use with care: You got to clone a PackUlong with a PackULong, a PackString with a PackString: Clone Object of the same type or it will crash . A test is done at the beginning to check that for both types are the sames, if not it does nothing. however it may still crash with 2 objects from unherited classes. Also, some type like PackObjectReference, will not clone its value by copying a pointer.Reference member clonage is done with BaseObject::Clone().

Protected Member Functions

void DeleteAllSubCells (void)

close and destroy the whole list.

void DeleteSubCellsProtectedRecursive (PackTreeCell *_pSubCellToDelete)

delete an element and its whole sub elements. the first to delete can be at any level.

void BeginChangeNotification ()

In edition mode, when a member of an object is changed (like in a Set()), you got to use BeginChangeNotification(), make your changes, and then EndChangeNotification(), so that the edition of this object and member is known by the context, and allows it to manage a GUI update and the undo stack.

void EndChangeNotification ()

In edition mode, when a member of an object is changed (like in a Set()), you got to use BeginChangeNotification(), make your changes, and then EndChangeNotification(), so that the edition of this object and member is known by the context, and allows it to manage a GUI update and the undo stack.

Protected Attributes

BaseTypeCreatorCallBackFunction m_CreatorFunction

a function pointer that return a new object of the type managed by the Tree.

BaseType * m_pObjectManaged

the object serialized by this cell:

PackULong mSerUlong_JumpToNextChunk

chunk length:

PackTreeCell * m_pFirstSerializedSubCell

member that manages the list of sub cell to serialize automatically. NULL if no subcellss.

PackTreeCell * m_pNextSerializedBrotherCell

member that manages the list of cell to serialize automatically. NULL if no subcells.

PackTreeCell ** m_ppPointerToAttachNextSerializedSubCellAtEnd

another member that manages the list of members to serialize automatically, and allow to grow the list by the end.

BaseObject * m_pObjectThatManagesThis

an object can belong (or not) to a BaseObject,( and to a BaseContext through it).

const char * m_pMemberName

If used as a member in an object, the member name, or NULL (not editable member).

const char * m_pMemberInfo

a short string explaining what's the object for in editable mode. OK if NULL (no info).

PackString * m_pValueString

a string standing for an expression of the value of the object:

unsigned char * m_pPreviousValueShape

used as a temp for object change notification in Begin/EndChangeNotification():

unsigned int m_PreviousValueShapeLength

Member Enumeration Documentation

enum eVedaUpdate [inherited]

enum used by BaseContext::NotifyObjectChange() to describe the notification meaning. Used by interfaces to monitor a context.

Enumerator:

eVedaUpdate_NoUpdate 0 means No Update.

eVedaUpdate_MemberIsGoingToChange Sent before a BaseObject member value change.( in order to lock the context to prevent object use from other thread.).

eVedaUpdate_MemberChanged a member of a BaseObject just changed.

eVedaUpdate_MemberChangedBecauseOfUndo a member of a BaseObject just changed, but because of an undo. you may treat it the same as eVedaUpdate_MemberChanged.

eVedaUpdate_MemberDestroyed Member of object Destroyed ! Watch out, the ID of the member is a dead pointer.

eVedaUpdate_ObjectNew new BaseObject created.

eVedaUpdate_ObjectDestroyed BaseObject just destroyed.Watch out, the ID of the object is a dead pointer.

eVedaUpdate_ObjectReCreated an object has just been Created; It's state has changed!

eVedaUpdate_ObjectClosed an object has just been closed; It's state has changed!

eVedaUpdate_NewRegisteredClass TODO: a new class has been registered to the context.

Definition at line 194 of file BaseType.h.

Constructor & Destructor Documentation

PackTreeCell ( BaseTypeCreatorCallBackFunction _func )

Constructor.

Parameters:

_func a function that return a new object to manage as an element of the list.

virtual ~PackTreeCell ( void ) [virtual]

Destructor.

Member Function Documentation

PackTreeCell* AddSubCellToThisCell ( int _indexWhereToInsert = -1 )

Add a new sub cell element, at the given index, to this Cell.

Parameters:

_indexWhereToInsert the index where to insert. if -1, at the end.

Returns:
the element created.

void BeginChangeNotification ( ) [protected, inherited]

In edition mode, when a member of an object is changed (like in a Set()), you got to use BeginChangeNotification(), make your changes, and then EndChangeNotification(), so that the edition of this object and member is known by the context, and allows it to manage a GUI update and the undo stack.

void DeleteAllSubCells ( void ) [protected]

close and destroy the whole list.

void DeleteSubCells ( PackTreeCell * _pSubCellToDelete )

delete an element and its whole sub elements. the first to delete can be at any level.

Parameters:

_pSubCellToDelete pointer to subcell.

void DeleteSubCellsProtectedRecursive ( PackTreeCell * _pSubCellToDelete ) [protected]

delete an element and its whole sub elements. the first to delete can be at any level.

Parameters:

_pSubCellToDelete pointer to subcell.

void EndChangeNotification ( ) [protected, inherited]

In edition mode, when a member of an object is changed (like in a Set()), you got to use BeginChangeNotification(), make your changes, and then EndChangeNotification(), so that the edition of this object and member is known by the context, and allows it to manage a GUI update and the undo stack.

virtual const char* GetClassID ( ) const [inline, virtual]

Each BaseType's inherited classes must explicit an ID for their class, or let use one of the super class at least through this virtual method. This is needed by GUIs to detect the types of each sub-members, and shape an interface for each Object according to their member list.

Returns:
a const character string, that must be unique and unchanged for all serializable base type.

Implements BaseType.
Definition at line 66 of file PackTreeCell.h.

PackTreeCell* GetFirstSubCell ( ) [inline]

get first subCell if there is any, or null if no subcell at all. It used to scan the tree.

Returns:
the cell element or 0L.

Definition at line 97 of file PackTreeCell.h.
References m_pFirstSerializedSubCell.

const char* GetMemberInfo ( ) const [inline, inherited]

Explicits the use of an object when used as a class member. It exists only in editable mode and can be used by any GUI. It should explain what the member does for the object.

Returns:
a short string explaining what's the object for, or NULL if not set.

Definition at line 144 of file BaseType.h.
References BaseType::m_pMemberInfo.

const char* GetMemberName ( ) const [inline, inherited]

Explicits the name of an object when used as a class member. It exists only in editable mode, and then can be used by any GUI. A member with an infoString not NULL, should be drawn in a GUI and receive updates. an object member with GetMemberName() to NULL should not be edited by an interface or undo-managed. set with SetMemberName().

Returns:
the member name or NULL

Definition at line 123 of file BaseType.h.
References BaseType::m_pMemberName.

PackTreeCell* GetNextBrotherCell ( ) [inline]

get next brother cell in the hierarchy, or null if last of the brotherhood. It used to scan the tree.

Returns:
the cell element or 0L.

Definition at line 91 of file PackTreeCell.h.
References m_pNextSerializedBrotherCell.

BaseType* GetObject ( ) [inline]

Return a pointer on the BaseType managed by this cell:.

Returns:
the object. should never be zero.

Definition at line 84 of file PackTreeCell.h.
References m_pObjectManaged.

BaseObject* GetObjectThatManagesThis ( ) [inline, inherited]

If there is any, get the object that manages this one as a member.

Returns:
the object that manages this one as a member, or NULL

Definition at line 170 of file BaseType.h.
References BaseType::m_pObjectThatManagesThis.

virtual unsigned int GetSerializedDescriptionSize ( void ) [virtual]

get the size of the whole byte chunk that will be written by Serialize_Out().

Returns:
byte size of the serialisation to do.

Implements BaseType.

void MakeCloneOf ( BaseType & _ModelObject ) [inherited]

Tool that makes an object take the values of another using serialization. Use with care: You got to clone a PackUlong with a PackULong, a PackString with a PackString: Clone Object of the same type or it will crash . A test is done at the beginning to check that for both types are the sames, if not it does nothing. however it may still crash with 2 objects from unherited classes. Also, some type like PackObjectReference, will not clone its value by copying a pointer.Reference member clonage is done with BaseObject::Clone().

Parameters:

_ModelObject the object took as a model.

virtual unsigned int ReadFile ( const char * _pFileName ) [virtual, inherited]

Try to read a serialized form, using Serialize_In().

Parameters:

_pFileName the file path.

Returns:
0 if OK.

virtual const unsigned char* Serialize_In ( const unsigned char * _pDescriptionChunk ) [virtual]

Read the object description from a byte chunk. Could crash if chunk not valid.

Parameters:

_pDescriptionChunk the objet description chunk.

Returns:
the end of the chunk written, possibly unlocated. Don't use this if you don't need it.

Implements BaseType.

virtual unsigned char* Serialize_Out ( unsigned char * _pDescriptionChunkToFill ) [virtual]

write the Current object definition to a Chunk using private packed types, recursively.

Parameters:

_pDescriptionChunkToFill the chunk where to write the objet description chunk.

Returns:
the end of the chunk written, possibly unlocated. Don't use this if you don't need it.

Implements BaseType.

void SetMemberInfo ( const char * _MemberInfo ) [inherited]

Explicits the use of an object when used as a class member. It should explain what the member does for the object. It exists only in editable mode,and can be used by any GUI. Don't use html tags , only \n are allowed. Use REGISTER_MEMBER_INFO macro after the REGISTER_MEMBER macro in the constructors. It can be left NULL.

Parameters:

_MemberName a short string explaining what's the object for.

void SetMemberName ( const char * _MemberName ) [inherited]

Explicits the name of an object when used as a class member. It exists only in editable mode, and then can be used by any GUI. A member with an infoString not NULL, should be drawn in a GUI and receive updates. an object member with GetMemberName() returning NULL should not be edited by an interface or undo-managed. Use REGISTER_MEMBER macros family: it registers the members and use SetMemberName() automatically (or not, according to the compilation mode).

Parameters:

_MemberName the member name

virtual void SetObjectThatManagesThis ( BaseObject * _pManager ) [virtual]

The Object this one belong to as a member. Should only be used at init.

Parameters:

_pManager BaseObject

Reimplemented from BaseType.

virtual const char* ValueToString ( ) [virtual, inherited]

convert the value of this object to an explicit string. The object manages the string privately, so just read it or copy it. the string would be destroyed with the objects, and changed when using Set() methods.

Returns:
the value as a const string.

Reimplemented in PackDynamicType, PackFloat, PackLong, PackObjectReference, PackString, PackStruct, PackULong, PackULong_Enums, and PackULong_Flags.

virtual unsigned int WriteFile ( const char * _pFileName ) [virtual, inherited]

write a serialized form, using GetSerializedDescriptionSize() and Serialize_Out().

Parameters:

_pFileName the file path.

Returns:
0 if OK.

Member Data Documentation

BaseTypeCreatorCallBackFunction m_CreatorFunction [protected]

a function pointer that return a new object of the type managed by the Tree.

Parameters:

_pSubCellToClone the cell element to clone.

Definition at line 137 of file PackTreeCell.h.

PackTreeCell* m_pFirstSerializedSubCell [protected]

member that manages the list of sub cell to serialize automatically. NULL if no subcellss.

Definition at line 146 of file PackTreeCell.h.
Referenced by GetFirstSubCell().

const char* m_pMemberInfo [protected, inherited]

a short string explaining what's the object for in editable mode. OK if NULL (no info).

Definition at line 259 of file BaseType.h.
Referenced by BaseType::GetMemberInfo().

const char* m_pMemberName [protected, inherited]

If used as a member in an object, the member name, or NULL (not editable member).

Definition at line 255 of file BaseType.h.
Referenced by BaseType::GetMemberName().

PackTreeCell* m_pNextSerializedBrotherCell [protected]

member that manages the list of cell to serialize automatically. NULL if no subcells.

Definition at line 149 of file PackTreeCell.h.
Referenced by GetNextBrotherCell().

BaseType* m_pObjectManaged [protected]

the object serialized by this cell:

Definition at line 140 of file PackTreeCell.h.
Referenced by GetObject().

BaseObject* m_pObjectThatManagesThis [protected, inherited]

an object can belong (or not) to a BaseObject,( and to a BaseContext through it).

Definition at line 251 of file BaseType.h.
Referenced by BaseType::GetObjectThatManagesThis().

PackTreeCell** m_ppPointerToAttachNextSerializedSubCellAtEnd [protected]

another member that manages the list of members to serialize automatically, and allow to grow the list by the end.

Definition at line 152 of file PackTreeCell.h.

unsigned char* m_pPreviousValueShape [protected, inherited]

used as a temp for object change notification in Begin/EndChangeNotification():

Definition at line 269 of file BaseType.h.

PackString* m_pValueString [protected, inherited]

a string standing for an expression of the value of the object:

Definition at line 264 of file BaseType.h.

PackULong mSerUlong_JumpToNextChunk [protected]

chunk length:

Definition at line 143 of file PackTreeCell.h.

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

Veda/PackTreeCell.h

      /\/\        4         N         k         !         N         D
                      _______  _ __ ___  _____            ___ _ _  ____
     ___________  __//___   /________  |/    / ___________\_______/    \
    /   _   _   \/   _     /    _   /      _/_/____/    _       __     /
   /    /   /       /     /    /    \      \/     /    /    \   \     /
  \\___/___/___/    ¯    _____/_____/       ______\___/_____/\________\\
               \________/_ ___ __ l____\      /elD!  
                 http://www.m4nkind.com \____/


Public Types
enum	eVedaUpdate { eVedaUpdate_NoUpdate = 0, eVedaUpdate_MemberIsGoingToChange, eVedaUpdate_MemberChanged, eVedaUpdate_MemberChangedBecauseOfUndo, eVedaUpdate_MemberDestroyed, eVedaUpdate_ObjectNew, eVedaUpdate_ObjectDestroyed, eVedaUpdate_ObjectReCreated, eVedaUpdate_ObjectClosed, eVedaUpdate_NewRegisteredClass }
	enum used by BaseContext::NotifyObjectChange() to describe the notification meaning. Used by interfaces to monitor a context. More...
Public Member Functions
	PackTreeCell (BaseTypeCreatorCallBackFunction _func)
	Constructor.
virtual	~PackTreeCell (void)
	Destructor.
virtual const unsigned char *	Serialize_In (const unsigned char *_pDescriptionChunk)
	Read the object description from a byte chunk. Could crash if chunk not valid.
virtual unsigned int	GetSerializedDescriptionSize (void)
	get the size of the whole byte chunk that will be written by Serialize_Out().
virtual unsigned char *	Serialize_Out (unsigned char *_pDescriptionChunkToFill)
	write the Current object definition to a Chunk using private packed types, recursively.
virtual const char *	GetClassID () const
	Each BaseType's inherited classes must explicit an ID for their class, or let use one of the super class at least through this virtual method. This is needed by GUIs to detect the types of each sub-members, and shape an interface for each Object according to their member list.
virtual void	SetObjectThatManagesThis (BaseObject *_pManager)
	The Object this one belong to as a member. Should only be used at init.
PackTreeCell *	AddSubCellToThisCell (int _indexWhereToInsert=-1)
	Add a new sub cell element, at the given index, to this Cell.
BaseType *	GetObject ()
	Return a pointer on the BaseType managed by this cell:.
PackTreeCell *	GetNextBrotherCell ()
	get next brother cell in the hierarchy, or null if last of the brotherhood. It used to scan the tree.
PackTreeCell *	GetFirstSubCell ()
	get first subCell if there is any, or null if no subcell at all. It used to scan the tree.
void	DeleteSubCells (PackTreeCell *_pSubCellToDelete)
	delete an element and its whole sub elements. the first to delete can be at any level.
virtual unsigned int	WriteFile (const char *_pFileName)
	write a serialized form, using GetSerializedDescriptionSize() and Serialize_Out().
virtual unsigned int	ReadFile (const char *_pFileName)
	Try to read a serialized form, using Serialize_In().
void	SetMemberName (const char *_MemberName)
	Explicits the name of an object when used as a class member. It exists only in editable mode, and then can be used by any GUI. A member with an infoString not NULL, should be drawn in a GUI and receive updates. an object member with GetMemberName() returning NULL should not be edited by an interface or undo-managed. Use REGISTER_MEMBER macros family: it registers the members and use SetMemberName() automatically (or not, according to the compilation mode).
const char *	GetMemberName () const
	Explicits the name of an object when used as a class member. It exists only in editable mode, and then can be used by any GUI. A member with an infoString not NULL, should be drawn in a GUI and receive updates. an object member with GetMemberName() to NULL should not be edited by an interface or undo-managed. set with SetMemberName().
void	SetMemberInfo (const char *_MemberInfo)
	Explicits the use of an object when used as a class member. It should explain what the member does for the object. It exists only in editable mode,and can be used by any GUI. Don't use html tags , only \n are allowed. Use REGISTER_MEMBER_INFO macro after the REGISTER_MEMBER macro in the constructors. It can be left NULL.
const char *	GetMemberInfo () const
	Explicits the use of an object when used as a class member. It exists only in editable mode and can be used by any GUI. It should explain what the member does for the object.
virtual const char *	ValueToString ()
	convert the value of this object to an explicit string. The object manages the string privately, so just read it or copy it. the string would be destroyed with the objects, and changed when using Set() methods.
BaseObject *	GetObjectThatManagesThis ()
	If there is any, get the object that manages this one as a member.
void	MakeCloneOf (BaseType &_ModelObject)
	Tool that makes an object take the values of another using serialization. Use with care: You got to clone a PackUlong with a PackULong, a PackString with a PackString: Clone Object of the same type or it will crash . A test is done at the beginning to check that for both types are the sames, if not it does nothing. however it may still crash with 2 objects from unherited classes. Also, some type like PackObjectReference, will not clone its value by copying a pointer.Reference member clonage is done with BaseObject::Clone().
Protected Member Functions
void	DeleteAllSubCells (void)
	close and destroy the whole list.
void	DeleteSubCellsProtectedRecursive (PackTreeCell *_pSubCellToDelete)
	delete an element and its whole sub elements. the first to delete can be at any level.
void	BeginChangeNotification ()
	In edition mode, when a member of an object is changed (like in a Set()), you got to use BeginChangeNotification(), make your changes, and then EndChangeNotification(), so that the edition of this object and member is known by the context, and allows it to manage a GUI update and the undo stack.
void	EndChangeNotification ()
	In edition mode, when a member of an object is changed (like in a Set()), you got to use BeginChangeNotification(), make your changes, and then EndChangeNotification(), so that the edition of this object and member is known by the context, and allows it to manage a GUI update and the undo stack.
Protected Attributes
BaseTypeCreatorCallBackFunction	m_CreatorFunction
	a function pointer that return a new object of the type managed by the Tree.
BaseType *	m_pObjectManaged
	the object serialized by this cell:
PackULong	mSerUlong_JumpToNextChunk
	chunk length:
PackTreeCell *	m_pFirstSerializedSubCell
	member that manages the list of sub cell to serialize automatically. NULL if no subcellss.
PackTreeCell *	m_pNextSerializedBrotherCell
	member that manages the list of cell to serialize automatically. NULL if no subcells.
PackTreeCell **	m_ppPointerToAttachNextSerializedSubCellAtEnd
	another member that manages the list of members to serialize automatically, and allow to grow the list by the end.
BaseObject *	m_pObjectThatManagesThis
	an object can belong (or not) to a BaseObject,( and to a BaseContext through it).
const char *	m_pMemberName
	If used as a member in an object, the member name, or NULL (not editable member).
const char *	m_pMemberInfo
	a short string explaining what's the object for in editable mode. OK if NULL (no info).
PackString *	m_pValueString
	a string standing for an expression of the value of the object:
unsigned char *	m_pPreviousValueShape
	used as a temp for object change notification in Begin/EndChangeNotification():
unsigned int	m_PreviousValueShapeLength

PackTreeCell Class Reference [Base Type Serializable Classes]

Detailed Description

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

PackTreeCell Class Reference
[Base Type Serializable Classes]