OdDbDatabase::insert Method (OdString&, OdString&, OdDbDatabase*, bool)

Syntax

C++

OdDbObjectId insert(const OdString& sourceBlockName, const OdString& destinationBlockName, OdDbDatabase* pSource, bool preserveSourceDatabase = true);

Parameters

Parameters	Description
const OdString& sourceBlockName	[in] Name of the OdDbBlockTableRecord in pSource.
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 folloowing 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.

All entities in the BlockTableRecord specified by sourceBlockName in pSource are copied into the new OdDbBlockTableRecord and offset by the INSBASE value. Contents of layout blocks are copied only if sourceBlockName is a layout block name.

Group

insert Method

Send feedback about this topic