API Reference > OdDb Classes > OdDbObject Class > OdDbObject Methods > OdDbObject::handOverTo Method
OdDbObject::handOverTo Method
Collapse All
Syntax
C++
void handOverTo(OdDbObject* pNewObject, bool keepXData = true, bool keepExtDict = true);
Parameters
Parameters 
Description 
OdDbObject* pNewObject 
[in] Pointer to the object with which to replace this object in the database.  
bool keepXData = true 
[in] This object's XData will be retained if and only if keepXData is true.  
bool keepExtDict = true 
[in] This object's extension dictionary will be retained if and only if keepExtDict is true. 
Description

Replaces this database -resident (DBRO) object with the specified non- database -resident (NDBRO) object, while retaining this object's objectId, handle, owner, and reactor list. 

 

Remarks

This object must be open OdDb::kForWrite. 

The replacement object will opened OdDb::kForWrite, and must be closed. 

It is up to the caller to delete the replaced (this) object.

Group
Copyright © 2002–2021. Open Design Alliance. All rights reserved.
Send feedback about this topic