Attaches an external reference (xref) to the drawing.

See Also | Example

Signature

RetVal = object.AttachExternalReference (PathName, Name, InsertionPoint, XScale, YScale, ZScale, Rotation, bOverlay [, Password])

Object

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

PathName

String; input-only
The full path and file name of the drawing to be referenced.

Name

String; input-only
The name for the xref to be created.

InsertionPoint

Variant (three-element array of Doubles); input-only
The 3D WCS coodinates specifying the point at which an ExternalReference instance is inserted into the drawing. The insertion point in the current drawing is aligned with the point defined by the BASE system variable in the referenced file.

XScale

Double; input-only
The X scaling factor for the xref instance.

YScale

Double; input-only
The Y scaling factor for the xref instance.

ZScale

Double; input-only
The Z scaling factor for the xref instance.

Rotation

Double; input-only
The rotation angle for the xref instance. This angle is specified in radians.

bOverlay

Boolean; input-only

TRUE: The xref instance is an overlay.

FALSE: The xref instance is an attachment.

Password

Variant; input-only; optional

RetVal

ExternalReference object
The newly created ExternalReference object.

Remarks

Like Block objects, attached ExternalReference objects can be nested. If another person is editing the drawing to be referenced, the drawing attached is based on the most recently saved version.

If the referenced file is missing or corrupt, its data is not displayed in the current drawing.