Inserts a drawing file or a named block that has been defined in the current drawing.

See Also | Example

Signature

RetVal = object.InsertBlock(InsertionPoint, Name, Xscale, Yscale, ZScale, Rotation [, Password])

Object

ModelSpace, PaperSpace, Block
The object or objects this method applies to.

InsertionPoint

Variant (three-element array of doubles); input-only
The 3D WCS coordinates specifying the location in the drawing to insert the block.

Name

String; input-only
The name of the AutoCAD drawing file or the name of the block to insert. If it is a file name, include the .dwg extension and any path information necessary for AutoCAD to find the file.

Xscale

Double; input-only; optional
The default equals 1.0. Must be a positive number.

Yscale

Double; input-only; optional
The default equals 1.0. Must be a positive number.

Zscale

Double; input-only; optional
The default equals 1.0. Must be a positive number.

Rotation

Double; input-only; optional
The default equals 0.0 radians.

Password

Variant; input-only; optional

RetVal

BlockRef object
The placed block as a Block Reference object.

Remarks

Inserting a block into another block will create nested blocks.

Attempting to call the InsertBlock method with an uninitialized Name parameter results in unexpected behavior.