Edit

Shapes.AddOLEObject method (Word)

  • Article

Creates an OLE object. Returns the InlineShape object that represents the new OLE object.

Syntax

expression. AddOLEObject( _ClassType_ , _FileName_ , _LinkToFile_ , _DisplayAsIcon_ , _IconFileName_ , _IconIndex_ , _IconLabel_ , _Range_ )

expression Required. A variable that represents a Shapes object.

Parameters

Name Required/Optional Data type Description
ClassType Optional Variant The name of the application used to activate the specified OLE object.
FileName Optional Variant The file from which the object is to be created. If this argument is omitted, the current folder is used. You must specify either the ClassType or FileName argument for the object, but not both.
LinkToFile Optional Variant True to link the OLE object to the file from which it was created. False to make the OLE object an independent copy of the file. If you specified a value for ClassType, the LinkToFile argument must be False. The default value is False.
DisplayAsIcon Optional Variant True to display the OLE object as an icon. The default value is False.
IconFileName Optional Variant The file that contains the icon to be displayed.
IconIndex Optional Variant The index number of the icon within IconFileName. The order of icons in the specified file corresponds to the order in which the icons appear in the Change Icon dialog box when the Display as icon check box is selected. The first icon in the file has the index number 0 (zero). If an icon with the given index number doesn't exist in IconFileName, the icon with the index number 1 (the second icon in the file) is used. The default value is 0 (zero).
IconLabel Optional Variant A label (caption) to be displayed beneath the icon.
Range Optional Variant The range where the OLE object will be placed in the text. The OLE object replaces the range, unless the range is collapsed. If this argument is omitted, the object is placed automatically.

Return value

InlineShape

Example

This example adds a new floating bitmap image to the active document. The bitmap is linked to another file.

ActiveDocument.Shapes.AddOLEObject _ 
 FileName:="c:\my documents\MyDrawing.bmp", _ 
 LinkToFile:=True

See also

Shapes Collection Object

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.