API Reference > OdDAI Namespace > Classes > Model Class > Model Methods > Model::insertEntityInstance Method
Model::insertEntityInstance Method
Collapse All
Syntax
C++
OdDAIObjectId insertEntityInstance(ApplicationInstancePtr pInstanceToInsert, const OdDbHandle& insertHandle);
Parameters
Parameters 
Description 
ApplicationInstancePtr pInstanceToInsert 
[in] A smart pointer to the entity instance to be inserted.  
const OdDbHandle& insertHandle 
[in] A handle of the parent object where to insert the entity instance.  
Returns

An identifier of the inserted entity instance.

Description

Inserts a newly created entity instance to the model.

Remarks

If the entity being inserted already belongs to another model or it has been already appended or inserted before, the method returns a NULL object identifier. If the specified database handle already exists in the model, the entity defined with this handle gets a new handle value and the inserted entity (specified with the pInstanceToInsert parameter) takes the passed handle value (the insertHandle parameter value).

Group
Copyright (c) 2002-2021. Open Design Alliance. All rights reserved.
Send feedback about this topic