VCDuplicateInDrawOrder

Version:

5.0

Description:

Makes a copy of the specified entity using the entity's points and the current settings. The copy's draw order is set to immediately follow the original entity.

Declaration:

C/C++

extern "C" void WINAPI VCDuplicateInDrawOrder(short* iError, ENTITYHANDLE lH);

Delphi

procedure VCDuplicateInDrawOrder(var iError: Smallint; lH: Longint); stdcall;

ActiveX/COM

Sub DuplicateInDrawOrder(ByVal lH As Long)

Parameters:

lH - the handle of the entity to be duplicated

Return Value:

None

iError Code:

0 - Success
1 - Invalid world
2 - Entity handle out of range
3 - Unable to set entity as current

Notes:

Normally when adding new entities to the database using VCDuplicate... functions or VCAdd...Entity functions, the new entity is added at the end of the database and at the end of the draw order. VCDuplicateInDrawOrder performs the same entity duplication as VCDuplicate and additionally sets the draw order of the new entity immediately after the original entity without the need to separately use VCDrawCurrentEntityAfter.