Method MergeEntities

Namespace

vdWebLibrary

Assembly

JsPropertiesExtractor.dll

MergeEntities(object, object[])

Add the clone of passed entities belong to sourceDocument to this document's active layout entities

layers linetypes images textstyles hatchpatterns and blocks reference passed entities are also added to this document

public object[] MergeEntities(object sourceDocument, object[] entities)

Parameters

sourceDocument object

A document from an other canvas object whose objects will be addedto this canvas selected document

entities object[]

can be an array of figure objects or an array of figure handles

If it is undefined all sourceDocument.Model.Entities.Items are added to this document active layout entities

Returns

object[]

The the new entities added to this document as an array of objects

Examples

MergeEntities example

var vdcanvas;
var vdcanvas2;
function vdrawInitPageLoad() {
vdcanvas = vdmanager.AttachCanvas("canvas");
vdcanvas2 = vdmanager.AttachCanvas("canvas2");
}
....
vdcanvas.SelectDocument("drawing1.vds");
vdcanvas2.SelectDocument("drawing2.vds");
......
vdcanvas.MergeEntities(vdcanvas2.GetDocument());//add drawing2 model entities of vdcanvas2 to vdcanvas selected document active layout
vdcanvas.MergeEntities(vdcanvas2.GetDocument(), vdcanvas2.GetDocument().Model.Entities.Items);//add drawing2 model entities of vdcanvas2 to vdcanvas selected document active layout
vdcanvas.MergeEntities(vdcanvas2.GetDocument(), [vdcanvas2.GetDocument().Model.Entities.Items[0],vdcanvas2.GetDocument().Model.Entities.Items[1]]);//add the first two entities of drawing2 model entities of vdcanvas2 to vdcanvas selected document active layout
vdcanvas2.scriptCommand.select(null, function (_vdcanvas) { vdcanvas.MergeEntities(vdcanvas2.GetDocument(), _vdcanvas.scriptCommand.ActiveSelection()); });//prompt the user to select entities on vdcanvas2 and copy them to vdcanvas document's active layout