Public Member Functions | Protected Attributes | List of all members
a2dRefMap Class Reference

class to map references to objects stored in XML, in order to make the connection later on. More...

#include <gen.h>

Inheritance diagram for a2dRefMap:
Inheritance graph
Collaboration diagram for a2dRefMap:
Collaboration graph

Public Member Functions

 a2dRefMap ()
 ~a2dRefMap ()
virtual void Initialize ()
 initialize mapping tables
a2dHashMapIntToObject & GetObjectHashMap ()
 This is used to find multiple referenced objects by id.
a2dHashMapCreateObject & GetObjectCreateHashMap ()
 has to map symbolic names to real classnames.
a2dResolveIdList & GetResolveIdList ()
 list of not resolved objects
bool ResolveOrAdd (a2dSmrtPtr< a2dObject > *storedHere, const wxString &id=wxT(""))
 try to resolve the object that is in storedHere when it is a reference. More...
bool ResolveOrAdd (a2dAutoZeroPtr< a2dObject > *storedHere, const wxString &id=wxT(""))
 try to resolve the object that is in storedHere when it is a reference.
bool ResolveOrAddLink (a2dObject *obj, const wxString &id=wxT(""))
 try to resolve an object referenced by obj using the LinkReference function
void ResolveInform (a2dObject *obj)
 call the objects LinkReference function (ptr=0) to inform it that links are done
void SetLastObjectLoadedId (const wxString &lastid)
 set by RefObject when finding a reference id during loading.
virtual bool LinkReferences (bool ignoreNonResolved=false)
 link references to their destination More...
bool RemoveReference (const wxString &idToRemove)
 remove given reference if from reference map.
a2dError GetLastError () const
 get last error encountered
void SetLastError (a2dError error)
 set last error encountered
- Public Member Functions inherited from a2dObject
virtual bool ProcessEvent (wxEvent &event)
bool SearchDynamicEventTable (wxEvent &event)
void Connect (int winid, int lastId, int eventType, wxObjectEventFunction func, wxObject *userData=(wxObject *) NULL, wxEvtHandler *eventSink=(wxEvtHandler *) NULL)
bool Disconnect (int winid, int lastId, wxEventType eventType, wxObjectEventFunction func=NULL, wxObject *userData=(wxObject *) NULL, wxEvtHandler *eventSink=(wxEvtHandler *) NULL)
void ProcessConnectedEvent (wxEvent &event)
 wxCHECK_VERSION(2,9,0) More...
void ConnectEvent (wxEventType type, wxEvtHandler *eventSink)
bool DisconnectEvent (wxEventType type, wxEvtHandler *eventSink)
bool DisconnectEventAll (wxEvtHandler *eventSink)
 Remove all dynamic events in classA, going to classB (eventSink) More...
 a2dObject ()
virtual ~a2dObject ()
void operator= (const a2dObject &other)
 assignment operator
int GetOwnedBy ()
 like it to be protected, but this does not work with wxList macros More...
virtual a2dObjectSetNonDynamic ()
 Call to mark this object as non-dynamic (static/local/auto) More...
void CheckReferences ()
 Check zero reference count and delete if count is 0. More...
a2dObjectClone (CloneOptions options, a2dRefMap *refs=NULL) const
 create an exact copy of this property
 a2dObject (const a2dObject &other, CloneOptions options, a2dRefMap *refs)
virtual wxString GetName () const
 Returns the name of this object, if no name is given the internal id will be returned. More...
virtual void SetName (const wxString &name)
 Creates the a2dStringProperty PROPID_Name. More...
virtual bool IsTemporary_DontSave () const
 Check if this is a temporary object, which should not be saved.
void SaveAsDocument (a2dIOHandlerXmlSerOut &out)
 Save this object and all below as an XML document. More...
virtual void Save (wxObject *parent, a2dIOHandlerXmlSerOut &out, a2dObjectList *towrite)
 write all needed to an XML type of file called the CVG format More...
void LoadFromDocument (a2dIOHandlerXmlSerIn &parser)
 Load this object and all below from an XML document. More...
virtual void Load (wxObject *parent, a2dIOHandlerXmlSerIn &parser)
 load object from CVG file More...
wxInt64 GetUniqueSerializationId () const
 return a unique id for this object More...
virtual bool AlwaysWriteSerializationId () const
 If true, always write an id. More...
virtual bool LinkReference (a2dObject *other)
 link a reference in the object to the given value More...
virtual void ResolveInform ()
 inform an object that reference resolution was done More...
void Walker (wxObject *parent, a2dWalkerIOHandler &handler)
 This is used to recursively walk through an object tree.
void SetCheck (bool check)
 general flag use at will. More...
bool GetCheck () const
 general flag use at will.
void SetRelease (bool value)
 set release flag More...
bool GetRelease () const
 get release flag More...
a2dAutoZeroPtr< a2dObject > ** GetAutoZeroPtrList ()
 return the list head pointer for autozero pointers to this object More...
a2dNamedPropertyGetProperty (const a2dPropertyId *propertyId, a2dPropertyId::Flags flags=a2dPropertyId::flag_none) const
 get property on this object More...
void SetProperty (a2dNamedProperty *propertyHolder, a2dPropertyId::SetFlags flags=a2dPropertyId::set_none)
 Set the property to the this object. More...
void SetProperty (const a2dNamedProperty &propertyHolder, a2dPropertyId::SetFlags flags=a2dPropertyId::set_none)
 Set the property to the this object and if enabled, to all childs and object members. More...
virtual a2dNamedPropertyFindProperty (const a2dPropertyId *id, a2dPropertyId::Flags flags=a2dPropertyId::flag_none)
 Find a dynamic property with given id in the property list. More...
virtual const a2dNamedPropertyFindProperty (const a2dPropertyId *id, a2dPropertyId::Flags flags=a2dPropertyId::flag_none) const
 Find a dynamic property with given id in the property list. More...
virtual bool HasProperty (const a2dPropertyId *id, const wxString &stringvalue=wxEmptyString) const
 Check if the object has a property with given id and string representation. More...
virtual void OnPropertyChanged (const a2dPropertyId *id)
 This function is called after a property changed. More...
virtual bool EditProperties (const a2dPropertyId *id, bool withUndo=true)
 edit properties of the object More...
void TakeOverProperties (a2dObject *from, a2dPropertyIdList *listOfIds)
 Properties in the id list are taken from the given object, en set to this. More...
wxURI GetURI () const
 quick way to get to PROPID_URI property More...
void SetURI (const wxURI &url)
 quickly set a property PROPID_URI More...
const a2dNamedPropertyListGetPropertyList () const
 Get the Property List. More...
bool HasDynamicProperties () const
 test if there are dynamic properties in the m_propertylist
virtual bool RemoveProperty (const a2dPropertyId *id, bool all=true)
 This function is called by a2dPropertyId to remove a property from the list. More...
void RemoveTemporaryProperties ()
 remove all temporary properties
virtual bool AddProperty (a2dNamedProperty *property)
 This function is called by a2dPropertyId to add a property to the list. More...

Protected Attributes

a2dHashMapIntToObject m_objecthashmap
 This is used to find multiple referenced objects by id.
a2dHashMapCreateObject m_objectCreate
 This is used to find a classname using a symbolic name.
a2dResolveIdList m_toResolve
 refernces to object which have not bin resolved yet ( e.g not read yet, but already referenced )
wxString m_lastObjectId
a2dError m_lastError
 set to last error found when parsing
- Protected Attributes inherited from a2dObject
a2dNamedPropertyList m_propertylist
int m_refcount
 how many references to this object do exist
bool m_check: 1
 used for linking multiple referenced objects when serializing
bool m_release: 1
 when set object is treated as being deleted, and wil be deleted in idle time.
bool m_recursion_active: 1
 this is used as a recursion stopper
bool m_pendingDisconnects: 1
unsigned int m_iteratorCount
a2dAutoZeroPtr< a2dObject > * m_autozeroptrlist
 this is a list of all a2dAutoZeroPtr object pointing to this object

Additional Inherited Members

- Public Types inherited from a2dObject
enum  CloneOptions {
  clone_members = 0x00000001, clone_properties = 0x00000002, clone_childs = 0x00000004, clone_unused = 0x00000008,
  clone_setoriginal = 0x00000010, clone_seteditcopy = 0x00000020, clone_noReference = 0x00000040, clone_noCameleonRef = 0x00000080,
  clone_toDrag = 0x00000100, clone_flat = 0x00000000, clone_deep = clone_members | clone_properties | clone_childs
 options for cloning More...
typedef a2dAutoZeroPtr< a2dObjectTAutoZeroPtrListClass
 this is needed inside the smart pointer template code
- Static Public Attributes inherited from a2dObject
static a2dPropertyIdBoolPROPID_Check = NULL
 used for linking multiple referenced objects when serializing
static a2dPropertyIdUriPROPID_URI = NULL
 attach an URL to the object
static a2dPropertyIdStringPROPID_Name = NULL
 Name property, to return name of this object.
static a2dPropertyIdVoidPtrPROPID_autozeroptrlist = NULL
static const a2dSignal sm_Edit_properties = wxNewId()
 edit properties event, see EditProperties()
- Protected Types inherited from a2dObject
enum  { refcount_nondynamic = 0x76543210 }
 special refcount value for non-dynamic objects
- Protected Member Functions inherited from a2dObject
virtual bool DoIgnoreIfNotMember (const a2dPropertyId *id) const
 used to decide if a property shall be ignored, if it is not a member More...
virtual void DoWalker (wxObject *parent, a2dWalkerIOHandler &handler)
 iterate over this object and its children More...

Detailed Description

class to map references to objects stored in XML, in order to make the connection later on.

Definition at line 3462 of file gen.h.

Member Function Documentation

bool a2dRefMap::LinkReferences ( bool  ignoreNonResolved = false)

link references to their destination

Override this to define input format specific needs for linking references in a certain format. In the default situation the parser uses m_objecthashmap to store object to which references can be made, while m_lastObjectId is used to store unresolved references. Here those too are resolved.

In the CVG format one can store multiple refrences to one and the same object. The object that is referenced is only written once, for the other references only the object with refid or specific id attributes are written to the CVG file. When loading a file in CVG, such references are resolved and removed from the document. So in the end the old reference is restored. When loading an object, it is created, but its contents will be empty, after resolving, this one will be replaced by the real referenced object. The reason behind all this, is that the actual object might need to be read yet, when a reference is encountered in the CVG file, and therefore the link can not be directly created. In other formats references are used in a simular manner, and to resolve them the same mechanism is used.

Some input/ouput formats are organized in a list of grouped objects, the hierarchy is created after the whole file is read into memory. All non referenced objects are direct childs of the rootobject. In the GDSII format these are called top structures.

true if all references were resolved.

Definition at line 4862 of file gen.cpp.

bool a2dRefMap::ResolveOrAdd ( a2dSmrtPtr< a2dObject > *  storedHere,
const wxString &  id = wxT( "" ) 

try to resolve the object that is in storedHere when it is a reference.

If not succes, add it to m_toResolve.

storedHerepointer to the smart pointer, that is to be set
idobject id of the referenced object. if "" SetLastObjectLoadedId is used.

Definition at line 4760 of file gen.cpp.

The documentation for this class was generated from the following files:
a2dRefMap Class Reference -- Sun Oct 12 2014 17:04:47 -- Sun Oct 12 2014 -- 1.8.5 -- wxArt2D -- . -- Main Page Reference Documentation