API Reference > OdDg Classes > OdDgElement Class > OdDgElement Methods > OdDgElement::subHandOverTo Method
OdDgElement::subHandOverTo Method
Syntax
C++
virtual void subHandOverTo(OdDgElement* pNewElement);
Parameters 
Description 
OdDgElement* pNewElement 
[in] Pointer to the object with which to replace this object in the database. 

Called as the first operation of the handOverTo function. 

 

This function allows custom classes to populate the new object. 

Overriding this function in a child class allows a child instance to be notified each time an object is handed over. 

This function is notified just before an object is to be handed over; giving this function the ability to cancel the handover. 

When overriding this function: 

1) If the OdDgElements's state is incorrect, throw exception. 

2) Call parent class's subHandover(). 

3) If other actions are required before handover, do them. 

The default implementation of this function does nothing. This function can be overridden in custom classes.

Copyright © 2002–2021. Open Design Alliance. All rights reserved.