Shape.InsertFromFile Method

Visio Automation Reference

Adds a linked or embedded object to a page, master, or group.

Version Information
 Version Added:  Visio 4.1

Syntax

expression.InsertFromFile(FileName, Flags)

expression   A variable that represents a Shape object.

Parameters

Name Required/Optional Data Type Description
FileName Required String The name of the file that contains the object to link or embed.
Flags Required Integer Flags that influence how the object is inserted.

Return Value
Shape

Remarks

The InsertFromFile method creates a new shape that represents a linked or embedded OLE object.

The Flags argument is a bitmask that should be a combination of the following values.

Constant Value Description

visInsertLink

&H8

If set, the new shape represents an OLE link to the named file. Otherwise, the InsertFromFile method produces an OLE object from the contents of the named file and embeds it in the document that contains the page, master, or group.

visInsertIcon

&H10

Displays the new shape as an icon.

Security Use caution when you are adding ActiveX controls to your application. ActiveX controls may be designed in such a way that their use could pose a security risk. We recommend that you use controls from trusted sources only.

See Also