Shapes.AddPicture Method

  • Article
PowerPoint Developer Reference

Creates a picture from an existing file. Returns a Shape object that represents the new picture.

Syntax

expression.AddPicture(FileName, LinkToFile, SaveWithDocument, Left, Top, Width, Height)

expression   A variable that represents a Shapes object.

Parameters

Name Required/Optional Data Type Description
FileName Required String The file from which the OLE object is to be created.
LinkToFile Required MsoTriState Determines whether the picture will be linked to the file from which it was created.
SaveWithDocument Required MsoTriState Determines whether the linked picture will be saved with the document into which it is inserted. This argument must be msoTrue if LinkToFile is msoFalse.
Left Required Single The position, measured in points, of the left edge of the picture relative to the left edge of the slide.
Top Required Single The position, measured in points, of the top edge of the picture relative to the top edge of the slide.
Width Optional Single The width of the picture, measured in points.
Height Optional Single The height of the picture, measured in points.

Return Value
Shape

Example

This example adds a picture created from the file Music.bmp to myDocument. The inserted picture is linked to the file from which it was created and is saved with myDocument.

Visual Basic for Applications 
  Set myDocument = ActivePresentation.Slides(1)
myDocument.Shapes.AddPicture FileName:="c:\microsoft office\" & _
    "clipart\music.bmp", LinkToFile:=msoTrue, SaveWithDocument:=msoTrue, _
    Left:=100, Top:=100, Width:=70, Height:=70

See Also