OdDbSurface::decomposeForSave Method
Syntax
C++
virtual OdDbObjectPtr decomposeForSave(OdDb::DwgVersion ver, OdDbObjectId& replaceId, bool& exchangeXData);
Description
DescriptionDetermines the behavior for custom objects when saving to .dwg or .dxf file.
Parameters|
Parameters |
Description |
|
ver |
[in] Drawing version to save as. |
|
replaceId |
[out] Object ID of the object replacing this object. |
|
exchangeXData |
[out] Set to true if and only if this function did not add XData to the replacement object. |
ReturnsOdDbObjectPtr for a non-database-resident (NDBRO) replacement object if replaceId is OdDbObjectId::kNull, or NULL otherwise.
RemarksThis method either:
- Returns an OdDbObjectPtr for a non-database-resident (NDBRO) replacement object, setting replaceId to OdDbObjectId::kNull.
- Returns NULL, setting replaceId for a database-resident (DBRO) replacement object.
Custom objects can decompose themselves into other objects, adding additional XData as required. The Drawings transfers XData from this object to the replacement object if and only if exchangeXData is true.
The default implementation returns NULL and sets replaceId to OdDbObjectId::kNull. This function can be overridden in custom classes.
The method is not intended to be called by client code. For processing owned objects use the convertForSave() method.
Links