Attaches an external reference (xref) to the drawing.
See Also | Example
RetVal = object.AttachExternalReference (PathName, Name, InsertionPoint, XScale, YScale, ZScale, Rotation, bOverlay [, Password])
The object or objects this method applies to.
The full path and file name of the drawing to be referenced.
The name for the xref to be created.
Variant (three-element array of Doubles);
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.
The X scaling factor for the xref instance.
The Y scaling factor for the xref instance.
The Z scaling factor for the xref instance.
The rotation angle for the xref instance. This angle is specified in radians.
TRUE: The xref instance is an overlay.
FALSE: The xref instance is an attachment.
Variant; input-only; optional
The newly created ExternalReference object.
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.