API Reference > OdDb Classes > OdDbDatabase Class > OdDbDatabase Methods > insert Method > OdDbDatabase::insert Method (OdString&, OdDbDatabase*, bool)
OdDbDatabase::insert Method (OdString&, OdDbDatabase*, bool)
Collapse All
Syntax
C++
OdDbObjectId insert(const OdString& destinationBlockName, OdDbDatabase* pSource, bool preserveSourceDatabase = true);
Parameters
Parameters 
Description 
const OdString& destinationBlockName 
[in] Name for the new OdDbBlockTableRecord.  
OdDbDatabase* pSource 
[in] Source database.  
bool preserveSourceDatabase = true 
[in] Not used. Objects from the source database are always copied, not moved. 
Description

Copies the content of a specified database to this database. 

 

Remarks

The data that will be copied includes content of the following enities:

  • BlockTable
  • LayerTable
  • LinetypeTable
  • DimStyleTable
  • RegAppTable
  • TextStyleTable
  • PlotStyleNameDictionary
  • PlotSettingsDictionary
  • MLStyleDictionary
  • ColorDictionary
  • MaterialDictionary
  • TableStyleDictionary
  • MLeaderStyleDictionary
  • ScaleListDictionary
  • VisualStyleDictionary
  • GroupDictionary

 

Unlike the wblockCloneObjects() method, insert() also copies the sortens table. While copying duplicate objects, names will be ignored; a destination object that has the same name as the source object will be rewritten by the source one. 

A new OdDbBlockTableRecord is created and all model space entities of pSource are copied into the new block.

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